Rocksolid Light

Welcome to novaBBS (click a section below)

mail  files  register  newsreader  groups  login

Message-ID:  

The price of success in philosophy is triviality. -- C. Glymour.


interests / alt.usage.english / Re: that I hope will ...

SubjectAuthor
* that I hope will ...hongy...@gmail.com
+- Re: that I hope will ...Kerr-Mudd, John
+* Re: that I hope will ...Peter T. Daniels
|`* Re: that I hope will ...hongy...@gmail.com
| `* Re: that I hope will ...Peter T. Daniels
|  `* Re: that I hope will ...hongy...@gmail.com
|   +* Re: that I hope will ...Peter T. Daniels
|   |`* Re: that I hope will ...Tony Cooper
|   | `* Re: that I hope will ...Kerr-Mudd, John
|   |  `* Re: that I hope will ...Peter Moylan
|   |   `* Re: that I hope will ...Ken Blake
|   |    +* Re: that I hope will ...Tony Cooper
|   |    |`* Re: that I hope will ...Ken Blake
|   |    | `- Re: that I hope will ...Tony Cooper
|   |    +* Re: that I hope will ...Peter Moylan
|   |    |`* Re: that I hope will ...Tony Cooper
|   |    | `* Re: that I hope will ...Peter T. Daniels
|   |    |  `* Re: that I hope will ...Peter Moylan
|   |    |   +- Re: that I hope will ...Peter T. Daniels
|   |    |   `* Re: that I hope will ...Ruud Harmsen
|   |    |    `- Re: that I hope will ...Peter Moylan
|   |    `* Re: that I hope will ...Paul Carmichael
|   |     `* Re: that I hope will ...Ruud Harmsen
|   |      `* Re: that I hope will ...Paul Carmichael
|   |       +- Re: that I hope will ...Peter T. Daniels
|   |       +* Re: that I hope will ...Ken Blake
|   |       |`- Re: that I hope will ...Snidely
|   |       `* Re: that I hope will ...Ruud Harmsen
|   |        +* Re: that I hope will ...Ken Blake
|   |        |`- Re: that I hope will ...Ruud Harmsen
|   |        `* Re: that I hope will ...Peter Moylan
|   |         `* Re: that I hope will ...Snidely
|   |          `* Re: that I hope will ...Sam Plusnet
|   |           `* Re: that I hope will ...Kerr-Mudd, John
|   |            `* Re: that I hope will ...David Kleinecke
|   |             `* Re: that I hope will ...Peter Moylan
|   |              +* Re: that I hope will ...Snidely
|   |              |`- Re: that I hope will ...Kerr-Mudd, John
|   |              `* Re: that I hope will ...Ken Blake
|   |               +- Re: that I hope will ...Athel Cornish-Bowden
|   |               `- Re: that I hope will ...Paul Carmichael
|   `* Re: that I hope will ...Hibou
|    `* Re: that I hope will ...hongy...@gmail.com
|     `- Re: that I hope will ...Hibou
+- Re: that I hope will ...Paul Carmichael
`- Re: that I hope will ...bil...@shaw.ca

Pages:12
Re: that I hope will ...

<luspug5c9llnhv4p9g7vcqelhaqcfvd9sp@4ax.com>

  copy mid

https://www.novabbs.com/interests/article-flat.php?id=111410&group=alt.usage.english#111410

  copy link   Newsgroups: alt.usage.english
Path: i2pn2.org!i2pn.org!eternal-september.org!reader02.eternal-september.org!.POSTED!not-for-mail
From: rh...@rudhar.com (Ruud Harmsen)
Newsgroups: alt.usage.english
Subject: Re: that I hope will ...
Date: Sun, 23 Jan 2022 07:21:41 +0100
Organization: A noiseless patient Spider
Lines: 34
Message-ID: <luspug5c9llnhv4p9g7vcqelhaqcfvd9sp@4ax.com>
References: <8d6655bf-3d42-457a-81bf-5f8f02ef3f84n@googlegroups.com> <4e3a8fd8-1dd1-49fd-8a57-698935fe8dd7n@googlegroups.com> <tf5kugtufdrfk0q9jhr3gtcqldoidc88v1@4ax.com> <20220121095124.313aae22ce6a77b49fe4bd4f@127.0.0.1> <ssfe3t$sh4$1@dont-email.me> <k7fmug57qtibbupr3opsfro187bfnemuag@4ax.com> <ssfojl$sqs$1@dont-email.me> <0f2nug5d01r1pc16kpvqle6uu9foj20i00@4ax.com> <988076bf-55c0-4514-a2dc-590d38dad6b5n@googlegroups.com> <ssi3d5$vee$1@dont-email.me>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Injection-Info: reader02.eternal-september.org; posting-host="f865dc57aeea51ab83cf12f787d037bc";
logging-data="25779"; mail-complaints-to="abuse@eternal-september.org"; posting-account="U2FsdGVkX19c/gALXfB6D2jpxaMbJLcz"
Cancel-Lock: sha1:asqHYyJ8tq1TXlmO/Wm7BbTXBgw=
X-Newsreader: Forte Agent 1.93/32.576 English (American)
 by: Ruud Harmsen - Sun, 23 Jan 2022 06:21 UTC

Sun, 23 Jan 2022 10:18:58 +1100: Peter Moylan
<peter@pmoylan.org.invalid> scribeva:

>On 23/01/22 05:50, Peter T. Daniels wrote:
>> On Saturday, January 22, 2022 at 1:15:02 PM UTC-5, Tony Cooper
>> wrote:
>>
>>> Because it's not something I do, I may not have linked to what you
>>> actually want to know. I don't know, for example, if there's a
>>> difference between "group" and "merge" in this context.
>>
>> Just as a guess -- from how tables and graphics work in Word and
>> PowerPoint -- Merge leaves you with a single cell, and Group leaves
>> you with a Group of two or more cells that can be Ungrouped. (In
>> PowerPoint, the Ungroup command is on the same dropdown menu as the
>> Group command.) I don't use Excel, though.
>
>This sort of thing used to be a lot easier when MS-Word and Excel had
>real menus.

They still have, I think: press Alt to see them.

>It became more difficult when the ribbon-type menus were
>introduced. It's not so easy remembering where the function you want is
>on the ribbons, especially since it has changed from version to version.
>Even when you're looking at the right ribbon it's easy to miss seeing it.
>
>And, of course, the "function" features tend to be hidden by the greater
>number of "appearance" features.
>
>Videos don't help here, because they are often for a version you don't have.

--
Ruud Harmsen, http://rudhar.com

Re: that I hope will ...

<pan$acb34$7b7ee067$8702c558$23270bb5@gmail.com>

  copy mid

https://www.novabbs.com/interests/article-flat.php?id=111416&group=alt.usage.english#111416

  copy link   Newsgroups: alt.usage.english
Path: i2pn2.org!i2pn.org!weretis.net!feeder8.news.weretis.net!news.mixmin.net!news2.arglkargh.de!news.karotte.org!fu-berlin.de!uni-berlin.de!individual.net!not-for-mail
From: wibbleyp...@gmail.com (Paul Carmichael)
Newsgroups: alt.usage.english
Subject: Re: that I hope will ...
Date: 23 Jan 2022 09:16:25 GMT
Lines: 31
Message-ID: <pan$acb34$7b7ee067$8702c558$23270bb5@gmail.com>
References: <eccd2bda-0132-4015-b261-c510e0f0f5bdn@googlegroups.com>
<5045ba3e-5411-436b-a4e5-31f509e0fe98n@googlegroups.com>
<8d6655bf-3d42-457a-81bf-5f8f02ef3f84n@googlegroups.com>
<4e3a8fd8-1dd1-49fd-8a57-698935fe8dd7n@googlegroups.com>
<tf5kugtufdrfk0q9jhr3gtcqldoidc88v1@4ax.com>
<20220121095124.313aae22ce6a77b49fe4bd4f@127.0.0.1>
<ssfe3t$sh4$1@dont-email.me> <k7fmug57qtibbupr3opsfro187bfnemuag@4ax.com>
<pan$a6f38$594e2061$8500134c$47455847@gmail.com>
<blmoug5rqie5phqp95trt6s3s4tihdprpb@4ax.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Trace: individual.net A4S54KKVYzz8Th8I4AcUOwKpt+AciNCmyl9fWODJac05kO5/8=
Cancel-Lock: sha1:mKOuv07QqGcgDTgwcB1ulv1Y0XQ=
User-Agent: Pan/0.147 (Sweet Solitude; 97d1711 github.com/GNOME/pan.git)
 by: Paul Carmichael - Sun, 23 Jan 2022 09:16 UTC

El Sat, 22 Jan 2022 20:28:51 +0100, Ruud Harmsen escribió:

> 22 Jan 2022 16:50:45 GMT: Paul Carmichael <wibbleypants@gmail.com>
> scribeva:
>
>>El Fri, 21 Jan 2022 16:15:34 -0700, Ken Blake escribió:
>>
>>> I think it's very rare that programmers write user documentation for
>>> the programs they write.
>
> I always did, and still do.
>
>>They are rarely expected to.
>
> They are, and I do expect myself to.

We are obviously from vastly different programming backgrounds.

I have never heard of a programmer being asked to produce end-user
documentation. Internal - yes.

Big companies often have entire departments devoted to documentation.
Unfortunately, the people that work in such departments are very mobile
and have little knowledge of the product.

--
Paul.

https://paulc.es/elpatio

Re: that I hope will ...

<77827a23-76b8-491e-9351-55f606a492cdn@googlegroups.com>

  copy mid

https://www.novabbs.com/interests/article-flat.php?id=111443&group=alt.usage.english#111443

  copy link   Newsgroups: alt.usage.english
X-Received: by 2002:a05:6214:18cd:: with SMTP id cy13mr11367541qvb.57.1642953703910;
Sun, 23 Jan 2022 08:01:43 -0800 (PST)
X-Received: by 2002:a25:4686:: with SMTP id t128mr17546205yba.396.1642953703725;
Sun, 23 Jan 2022 08:01:43 -0800 (PST)
Path: i2pn2.org!i2pn.org!weretis.net!feeder6.news.weretis.net!news.misty.com!border2.nntp.dca1.giganews.com!nntp.giganews.com!news-out.google.com!nntp.google.com!postnews.google.com!google-groups.googlegroups.com!not-for-mail
Newsgroups: alt.usage.english
Date: Sun, 23 Jan 2022 08:01:43 -0800 (PST)
In-Reply-To: <pan$acb34$7b7ee067$8702c558$23270bb5@gmail.com>
Injection-Info: google-groups.googlegroups.com; posting-host=100.8.211.134; posting-account=tXYReAoAAABbl0njRzivyU02EBLaX9OF
NNTP-Posting-Host: 100.8.211.134
References: <eccd2bda-0132-4015-b261-c510e0f0f5bdn@googlegroups.com>
<5045ba3e-5411-436b-a4e5-31f509e0fe98n@googlegroups.com> <8d6655bf-3d42-457a-81bf-5f8f02ef3f84n@googlegroups.com>
<4e3a8fd8-1dd1-49fd-8a57-698935fe8dd7n@googlegroups.com> <tf5kugtufdrfk0q9jhr3gtcqldoidc88v1@4ax.com>
<20220121095124.313aae22ce6a77b49fe4bd4f@127.0.0.1> <ssfe3t$sh4$1@dont-email.me>
<k7fmug57qtibbupr3opsfro187bfnemuag@4ax.com> <pan$a6f38$594e2061$8500134c$47455847@gmail.com>
<blmoug5rqie5phqp95trt6s3s4tihdprpb@4ax.com> <pan$acb34$7b7ee067$8702c558$23270bb5@gmail.com>
User-Agent: G2/1.0
MIME-Version: 1.0
Message-ID: <77827a23-76b8-491e-9351-55f606a492cdn@googlegroups.com>
Subject: Re: that I hope will ...
From: gramma...@verizon.net (Peter T. Daniels)
Injection-Date: Sun, 23 Jan 2022 16:01:43 +0000
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
Lines: 35
 by: Peter T. Daniels - Sun, 23 Jan 2022 16:01 UTC

On Sunday, January 23, 2022 at 4:16:30 AM UTC-5, Paul Carmichael wrote:
> El Sat, 22 Jan 2022 20:28:51 +0100, Ruud Harmsen escribió:
> > 22 Jan 2022 16:50:45 GMT: Paul Carmichael <wibble...@gmail.com>
> > scribeva:
> >>El Fri, 21 Jan 2022 16:15:34 -0700, Ken Blake escribió:

> >>> I think it's very rare that programmers write user documentation for
> >>> the programs they write.
> > I always did, and still do.
> >>They are rarely expected to.
> > They are, and I do expect myself to.
>
> We are obviously from vastly different programming backgrounds.
>
> I have never heard of a programmer being asked to produce end-user
> documentation. Internal - yes.
>
> Big companies often have entire departments devoted to documentation.
> Unfortunately, the people that work in such departments are very mobile
> and have little knowledge of the product.

When I went to the store for such things, I was faced with quite
an array of extensive series. The best ones proved to be "Missing
Manual" and "Bible" (the latter is a bit more comprehensive than
the ones in similar format published by Microsoft.) And a limited
series found only among the Bargain Books, "Made Easy." (Possibly
only for the four Office programs.) The PowerPoint one gave me
some new capabilities, and the Excel one is slightly understandable.

But I haven't had a reason to upgrade since 2013 so I don't know
what's available today -- the section seems smaller at the local
Barnes & Noble (Clifton, NJ), but they're retrenching in general: no
more CD/DVD department, and they closed the balcony entirely,
so that may be a local phenomenon.

Re: that I hope will ...

<ls4rugdfqj9he5n2p035srh0d6u4mk4mq8@4ax.com>

  copy mid

https://www.novabbs.com/interests/article-flat.php?id=111465&group=alt.usage.english#111465

  copy link   Newsgroups: alt.usage.english
Path: i2pn2.org!i2pn.org!weretis.net!feeder8.news.weretis.net!news.mixmin.net!news2.arglkargh.de!news.karotte.org!fu-berlin.de!uni-berlin.de!individual.net!not-for-mail
From: Ken...@invalid.news.com (Ken Blake)
Newsgroups: alt.usage.english
Subject: Re: that I hope will ...
Date: Sun, 23 Jan 2022 10:43:23 -0700
Lines: 33
Message-ID: <ls4rugdfqj9he5n2p035srh0d6u4mk4mq8@4ax.com>
References: <8d6655bf-3d42-457a-81bf-5f8f02ef3f84n@googlegroups.com> <4e3a8fd8-1dd1-49fd-8a57-698935fe8dd7n@googlegroups.com> <tf5kugtufdrfk0q9jhr3gtcqldoidc88v1@4ax.com> <20220121095124.313aae22ce6a77b49fe4bd4f@127.0.0.1> <ssfe3t$sh4$1@dont-email.me> <k7fmug57qtibbupr3opsfro187bfnemuag@4ax.com> <pan$a6f38$594e2061$8500134c$47455847@gmail.com> <blmoug5rqie5phqp95trt6s3s4tihdprpb@4ax.com> <pan$acb34$7b7ee067$8702c558$23270bb5@gmail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
X-Trace: individual.net 1MyU5ugMYLOT+qtjU/Uoiwqhy/j1iJl5Wp2aezZM7qFjE6qEXY
Cancel-Lock: sha1:7xzioZmA2qw+NkTVY2DLxv01+KQ=
X-Newsreader: Forte Agent 6.00/32.1186
 by: Ken Blake - Sun, 23 Jan 2022 17:43 UTC

On 23 Jan 2022 09:16:25 GMT, Paul Carmichael <wibbleypants@gmail.com>
wrote:

>El Sat, 22 Jan 2022 20:28:51 +0100, Ruud Harmsen escribió:
>
>> 22 Jan 2022 16:50:45 GMT: Paul Carmichael <wibbleypants@gmail.com>
>> scribeva:
>>
>>>El Fri, 21 Jan 2022 16:15:34 -0700, Ken Blake escribió:
>>>
>>>> I think it's very rare that programmers write user documentation for
>>>> the programs they write.
>>
>> I always did, and still do.
>>
>>>They are rarely expected to.
>>
>> They are, and I do expect myself to.
>
>We are obviously from vastly different programming backgrounds.
>
>I have never heard of a programmer being asked to produce end-user
>documentation. Internal - yes.

Yes.

>Big companies often have entire departments devoted to documentation.
>Unfortunately, the people that work in such departments are very mobile
>and have little knowledge of the product.

Yes, yes, and yes.

Re: that I hope will ...

<mn.bafb7e61fb941a0f.127094@snitoo>

  copy mid

https://www.novabbs.com/interests/article-flat.php?id=111505&group=alt.usage.english#111505

  copy link   Newsgroups: alt.usage.english
Path: i2pn2.org!i2pn.org!paganini.bofh.team!eternal-september.org!reader02.eternal-september.org!.POSTED!not-for-mail
From: snidely....@gmail.com (Snidely)
Newsgroups: alt.usage.english
Subject: Re: that I hope will ...
Date: Sun, 23 Jan 2022 12:43:06 -0800
Organization: Dis One
Lines: 47
Message-ID: <mn.bafb7e61fb941a0f.127094@snitoo>
References: <8d6655bf-3d42-457a-81bf-5f8f02ef3f84n@googlegroups.com> <4e3a8fd8-1dd1-49fd-8a57-698935fe8dd7n@googlegroups.com> <tf5kugtufdrfk0q9jhr3gtcqldoidc88v1@4ax.com> <20220121095124.313aae22ce6a77b49fe4bd4f@127.0.0.1> <ssfe3t$sh4$1@dont-email.me> <k7fmug57qtibbupr3opsfro187bfnemuag@4ax.com> <pan$a6f38$594e2061$8500134c$47455847@gmail.com> <blmoug5rqie5phqp95trt6s3s4tihdprpb@4ax.com> <pan$acb34$7b7ee067$8702c558$23270bb5@gmail.com> <ls4rugdfqj9he5n2p035srh0d6u4mk4mq8@4ax.com>
Reply-To: snidely.too@gmail.com
Mime-Version: 1.0
Content-Type: text/plain; charset="iso-8859-15"; format=flowed
Content-Transfer-Encoding: 8bit
Injection-Info: reader02.eternal-september.org; posting-host="d504f3fdb8a9306ccd8be9f943e9bd75";
logging-data="2303"; mail-complaints-to="abuse@eternal-september.org"; posting-account="U2FsdGVkX19qSNunD4v3nWMu2fuztE8/Wt+lXerGOBs="
Cancel-Lock: sha1:vPTGemcmihJZpUQkwDYpS6w2xG8=
X-Newsreader: MesNews/1.08.06.00-gb
X-ICQ: 543516788
 by: Snidely - Sun, 23 Jan 2022 20:43 UTC

Sunday, Ken Blake murmurred ...
> On 23 Jan 2022 09:16:25 GMT, Paul Carmichael <wibbleypants@gmail.com>
> wrote:
>
>> El Sat, 22 Jan 2022 20:28:51 +0100, Ruud Harmsen escribió:
>>
>>> 22 Jan 2022 16:50:45 GMT: Paul Carmichael <wibbleypants@gmail.com>
>>> scribeva:
>>>
>>>> El Fri, 21 Jan 2022 16:15:34 -0700, Ken Blake escribió:
>>>>
>>>>> I think it's very rare that programmers write user documentation for
>>>>> the programs they write.
>>>
>>> I always did, and still do.
>>>
>>>> They are rarely expected to.
>>>
>>> They are, and I do expect myself to.
>>
>> We are obviously from vastly different programming backgrounds.
>>
>> I have never heard of a programmer being asked to produce end-user
>> documentation. Internal - yes.
>
> Yes.
>
>
>> Big companies often have entire departments devoted to documentation.
>> Unfortunately, the people that work in such departments are very mobile
>> and have little knowledge of the product.
>
>
> Yes, yes, and yes.

And big companies are not the only ones producing software.

But the time I did work for a big company on something customer-facing,
I was asked to draft a user document, and only after I finished that
did it go to an editor. An editor, not a writer.

/dps

--
You could try being nicer and politer
> instead, and see how that works out.
-- Katy Jennison

Re: that I hope will ...

<aqirug1jecic1kutmdc39nobvsvg05rnpd@4ax.com>

  copy mid

https://www.novabbs.com/interests/article-flat.php?id=111525&group=alt.usage.english#111525

  copy link   Newsgroups: alt.usage.english
Path: i2pn2.org!i2pn.org!eternal-september.org!reader02.eternal-september.org!.POSTED!not-for-mail
From: rh...@rudhar.com (Ruud Harmsen)
Newsgroups: alt.usage.english
Subject: Re: that I hope will ...
Date: Sun, 23 Jan 2022 22:41:14 +0100
Organization: A noiseless patient Spider
Lines: 36
Message-ID: <aqirug1jecic1kutmdc39nobvsvg05rnpd@4ax.com>
References: <8d6655bf-3d42-457a-81bf-5f8f02ef3f84n@googlegroups.com> <4e3a8fd8-1dd1-49fd-8a57-698935fe8dd7n@googlegroups.com> <tf5kugtufdrfk0q9jhr3gtcqldoidc88v1@4ax.com> <20220121095124.313aae22ce6a77b49fe4bd4f@127.0.0.1> <ssfe3t$sh4$1@dont-email.me> <k7fmug57qtibbupr3opsfro187bfnemuag@4ax.com> <pan$a6f38$594e2061$8500134c$47455847@gmail.com> <blmoug5rqie5phqp95trt6s3s4tihdprpb@4ax.com> <pan$acb34$7b7ee067$8702c558$23270bb5@gmail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
Injection-Info: reader02.eternal-september.org; posting-host="f865dc57aeea51ab83cf12f787d037bc";
logging-data="25716"; mail-complaints-to="abuse@eternal-september.org"; posting-account="U2FsdGVkX1+bqEqCrQ6GuEFOYXNdsru6"
Cancel-Lock: sha1:0DagivxiP3jDql3sxsV8MYWLtlk=
X-Newsreader: Forte Agent 1.93/32.576 English (American)
 by: Ruud Harmsen - Sun, 23 Jan 2022 21:41 UTC

23 Jan 2022 09:16:25 GMT: Paul Carmichael <wibbleypants@gmail.com>
scribeva:

>El Sat, 22 Jan 2022 20:28:51 +0100, Ruud Harmsen escribió:
>
>> 22 Jan 2022 16:50:45 GMT: Paul Carmichael <wibbleypants@gmail.com>
>> scribeva:
>>
>>>El Fri, 21 Jan 2022 16:15:34 -0700, Ken Blake escribió:
>>>
>>>> I think it's very rare that programmers write user documentation for
>>>> the programs they write.
>>
>> I always did, and still do.
>>
>>>They are rarely expected to.
>>
>> They are, and I do expect myself to.
>
>We are obviously from vastly different programming backgrounds.
>
>I have never heard of a programmer being asked to produce end-user
>documentation. Internal - yes.

I did all of it.

>Big companies often have entire departments devoted to documentation.

Wrong approach. For me, anyway.

>Unfortunately, the people that work in such departments are very mobile
>and have little knowledge of the product.

That's exactly the problem.
--
Ruud Harmsen, http://rudhar.com

Re: that I hope will ...

<hvkrug5gqvnet3hoh376pas104tkthirpo@4ax.com>

  copy mid

https://www.novabbs.com/interests/article-flat.php?id=111549&group=alt.usage.english#111549

  copy link   Newsgroups: alt.usage.english
Path: i2pn2.org!i2pn.org!weretis.net!feeder8.news.weretis.net!lilly.ping.de!fu-berlin.de!uni-berlin.de!individual.net!not-for-mail
From: Ken...@invalid.news.com (Ken Blake)
Newsgroups: alt.usage.english
Subject: Re: that I hope will ...
Date: Sun, 23 Jan 2022 15:23:57 -0700
Lines: 58
Message-ID: <hvkrug5gqvnet3hoh376pas104tkthirpo@4ax.com>
References: <8d6655bf-3d42-457a-81bf-5f8f02ef3f84n@googlegroups.com> <4e3a8fd8-1dd1-49fd-8a57-698935fe8dd7n@googlegroups.com> <tf5kugtufdrfk0q9jhr3gtcqldoidc88v1@4ax.com> <20220121095124.313aae22ce6a77b49fe4bd4f@127.0.0.1> <ssfe3t$sh4$1@dont-email.me> <k7fmug57qtibbupr3opsfro187bfnemuag@4ax.com> <pan$a6f38$594e2061$8500134c$47455847@gmail.com> <blmoug5rqie5phqp95trt6s3s4tihdprpb@4ax.com> <pan$acb34$7b7ee067$8702c558$23270bb5@gmail.com> <aqirug1jecic1kutmdc39nobvsvg05rnpd@4ax.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
X-Trace: individual.net FdiFKIpvMjBEcotH5y5rEAGk4KVC8e75RCwKS7+TaBLQ2MWtli
Cancel-Lock: sha1:Gc96YNXI+VgzgUV9WP7VNlFOTrM=
X-Newsreader: Forte Agent 6.00/32.1186
 by: Ken Blake - Sun, 23 Jan 2022 22:23 UTC

On Sun, 23 Jan 2022 22:41:14 +0100, Ruud Harmsen <rh@rudhar.com>
wrote:

>23 Jan 2022 09:16:25 GMT: Paul Carmichael <wibbleypants@gmail.com>
>scribeva:
>
>>El Sat, 22 Jan 2022 20:28:51 +0100, Ruud Harmsen escribió:
>>
>>> 22 Jan 2022 16:50:45 GMT: Paul Carmichael <wibbleypants@gmail.com>
>>> scribeva:
>>>
>>>>El Fri, 21 Jan 2022 16:15:34 -0700, Ken Blake escribió:
>>>>
>>>>> I think it's very rare that programmers write user documentation for
>>>>> the programs they write.
>>>
>>> I always did, and still do.
>>>
>>>>They are rarely expected to.
>>>
>>> They are, and I do expect myself to.
>>
>>We are obviously from vastly different programming backgrounds.
>>
>>I have never heard of a programmer being asked to produce end-user
>>documentation. Internal - yes.
>
>I did all of it.

OK, we haven't all have the same experiences. But yours is very
unusual in my experience.

>>Big companies often have entire departments devoted to documentation.
>
>Wrong approach. For me, anyway.

To me, it's the right approach.

>>Unfortunately, the people that work in such departments are very mobile
>>and have little knowledge of the product.
>
>That's exactly the problem.

Yes, they have little knowledge of the product. But they shouldn't
write the documentation based on their personal knowledge. They should
do the writing, not provide the knowledge. The knowledge should be
imparted to them by the programmers.

I'm sure there are exceptions, but in my experience, it's a rare good
programmer who can write well, and it's a rare good writer who can
program well (or at all).

Re: that I hope will ...

<qnmruglmijqsoutlm1u1ht64qnpsap12jo@4ax.com>

  copy mid

https://www.novabbs.com/interests/article-flat.php?id=111554&group=alt.usage.english#111554

  copy link   Newsgroups: alt.usage.english
Path: i2pn2.org!i2pn.org!weretis.net!feeder8.news.weretis.net!eternal-september.org!reader02.eternal-september.org!.POSTED!not-for-mail
From: rh...@rudhar.com (Ruud Harmsen)
Newsgroups: alt.usage.english
Subject: Re: that I hope will ...
Date: Sun, 23 Jan 2022 23:49:20 +0100
Organization: A noiseless patient Spider
Lines: 13
Message-ID: <qnmruglmijqsoutlm1u1ht64qnpsap12jo@4ax.com>
References: <4e3a8fd8-1dd1-49fd-8a57-698935fe8dd7n@googlegroups.com> <tf5kugtufdrfk0q9jhr3gtcqldoidc88v1@4ax.com> <20220121095124.313aae22ce6a77b49fe4bd4f@127.0.0.1> <ssfe3t$sh4$1@dont-email.me> <k7fmug57qtibbupr3opsfro187bfnemuag@4ax.com> <pan$a6f38$594e2061$8500134c$47455847@gmail.com> <blmoug5rqie5phqp95trt6s3s4tihdprpb@4ax.com> <pan$acb34$7b7ee067$8702c558$23270bb5@gmail.com> <aqirug1jecic1kutmdc39nobvsvg05rnpd@4ax.com> <hvkrug5gqvnet3hoh376pas104tkthirpo@4ax.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Injection-Info: reader02.eternal-september.org; posting-host="f865dc57aeea51ab83cf12f787d037bc";
logging-data="19984"; mail-complaints-to="abuse@eternal-september.org"; posting-account="U2FsdGVkX1+4hKBMS2VHY8o+U84+v8S8"
Cancel-Lock: sha1:m34rmbvaq4bPNcnalfeanNvhdKk=
X-Newsreader: Forte Agent 1.93/32.576 English (American)
 by: Ruud Harmsen - Sun, 23 Jan 2022 22:49 UTC

Sun, 23 Jan 2022 15:23:57 -0700: Ken Blake <Ken@invalid.news.com>
scribeva:
>I'm sure there are exceptions, but in my experience, it's a rare good
>programmer who can write well, and it's a rare good writer who can
>program well (or at all).

True. I am exceptional.

I am now retired, can do what I want, and I program, test, implement,
document, write, translate, everything. No stupid managers going to
thwart me again. Plans to start playing and composing again too.
--
Ruud Harmsen, http://rudhar.com

Re: that I hope will ...

<sskq74$e1i$1@dont-email.me>

  copy mid

https://www.novabbs.com/interests/article-flat.php?id=111579&group=alt.usage.english#111579

  copy link   Newsgroups: alt.usage.english
Path: i2pn2.org!i2pn.org!eternal-september.org!reader02.eternal-september.org!.POSTED!not-for-mail
From: pet...@pmoylan.org.invalid (Peter Moylan)
Newsgroups: alt.usage.english
Subject: Re: that I hope will ...
Date: Mon, 24 Jan 2022 11:00:34 +1100
Organization: A noiseless patient Spider
Lines: 42
Message-ID: <sskq74$e1i$1@dont-email.me>
References: <8d6655bf-3d42-457a-81bf-5f8f02ef3f84n@googlegroups.com>
<4e3a8fd8-1dd1-49fd-8a57-698935fe8dd7n@googlegroups.com>
<tf5kugtufdrfk0q9jhr3gtcqldoidc88v1@4ax.com>
<20220121095124.313aae22ce6a77b49fe4bd4f@127.0.0.1>
<ssfe3t$sh4$1@dont-email.me> <k7fmug57qtibbupr3opsfro187bfnemuag@4ax.com>
<ssfojl$sqs$1@dont-email.me> <0f2nug5d01r1pc16kpvqle6uu9foj20i00@4ax.com>
<988076bf-55c0-4514-a2dc-590d38dad6b5n@googlegroups.com>
<ssi3d5$vee$1@dont-email.me> <luspug5c9llnhv4p9g7vcqelhaqcfvd9sp@4ax.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=windows-1252; format=flowed
Content-Transfer-Encoding: 7bit
Injection-Date: Mon, 24 Jan 2022 00:00:36 -0000 (UTC)
Injection-Info: reader02.eternal-september.org; posting-host="5e7ab7b0478ee340fd349edab3d16143";
logging-data="14386"; mail-complaints-to="abuse@eternal-september.org"; posting-account="U2FsdGVkX19E50fw0M9IvAKWDwmhl+/l"
User-Agent: Mozilla/5.0 (OS/2; Warp 4.5; rv:38.0) Gecko/20100101
Thunderbird/38.8.0
Cancel-Lock: sha1:sYnU1RTwS46JeiWBU5zCfIBwDRk=
In-Reply-To: <luspug5c9llnhv4p9g7vcqelhaqcfvd9sp@4ax.com>
 by: Peter Moylan - Mon, 24 Jan 2022 00:00 UTC

On 23/01/22 17:21, Ruud Harmsen wrote:
> Sun, 23 Jan 2022 10:18:58 +1100: Peter Moylan
> <peter@pmoylan.org.invalid> scribeva:
>
>> On 23/01/22 05:50, Peter T. Daniels wrote:
>>> On Saturday, January 22, 2022 at 1:15:02 PM UTC-5, Tony Cooper
>>> wrote:
>>>
>>>> Because it's not something I do, I may not have linked to what
>>>> you actually want to know. I don't know, for example, if
>>>> there's a difference between "group" and "merge" in this
>>>> context.
>>>
>>> Just as a guess -- from how tables and graphics work in Word and
>>> PowerPoint -- Merge leaves you with a single cell, and Group
>>> leaves you with a Group of two or more cells that can be
>>> Ungrouped. (In PowerPoint, the Ungroup command is on the same
>>> dropdown menu as the Group command.) I don't use Excel, though.
>>
>> This sort of thing used to be a lot easier when MS-Word and Excel
>> had real menus.
>
> They still have, I think: press Alt to see them.

In the version I have, pressing Alt seems to label the ribbon with
keyboard shortcuts. That's OK if you've memorised what's on the ribbon,
and what the keyboard shortcuts mean, but it's not the same as having a
menu drop down so that you can see whether what you're looking for is on
that menu.

The major difference, I guess, is that a menu has words while a ribbon
has pictographs. They didn't teach us pictographs in school.

But maybe it's different in different versions.

In Thunderbird, by the way, I have a real menu bar across the top even
though the Thunderbird designers moved to hamburgers. There's some
setting in Thunderbird, which I've now forgotten, which means "Bring
back the old menus".

--
Peter Moylan Newcastle, NSW http://www.pmoylan.org

Re: that I hope will ...

<sskqim$gjq$1@dont-email.me>

  copy mid

https://www.novabbs.com/interests/article-flat.php?id=111580&group=alt.usage.english#111580

  copy link   Newsgroups: alt.usage.english
Path: i2pn2.org!i2pn.org!eternal-september.org!reader02.eternal-september.org!.POSTED!not-for-mail
From: pet...@pmoylan.org.invalid (Peter Moylan)
Newsgroups: alt.usage.english
Subject: Re: that I hope will ...
Date: Mon, 24 Jan 2022 11:06:41 +1100
Organization: A noiseless patient Spider
Lines: 45
Message-ID: <sskqim$gjq$1@dont-email.me>
References: <8d6655bf-3d42-457a-81bf-5f8f02ef3f84n@googlegroups.com>
<4e3a8fd8-1dd1-49fd-8a57-698935fe8dd7n@googlegroups.com>
<tf5kugtufdrfk0q9jhr3gtcqldoidc88v1@4ax.com>
<20220121095124.313aae22ce6a77b49fe4bd4f@127.0.0.1>
<ssfe3t$sh4$1@dont-email.me> <k7fmug57qtibbupr3opsfro187bfnemuag@4ax.com>
<pan$a6f38$594e2061$8500134c$47455847@gmail.com>
<blmoug5rqie5phqp95trt6s3s4tihdprpb@4ax.com>
<pan$acb34$7b7ee067$8702c558$23270bb5@gmail.com>
<aqirug1jecic1kutmdc39nobvsvg05rnpd@4ax.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 8bit
Injection-Date: Mon, 24 Jan 2022 00:06:46 -0000 (UTC)
Injection-Info: reader02.eternal-september.org; posting-host="5e7ab7b0478ee340fd349edab3d16143";
logging-data="17018"; mail-complaints-to="abuse@eternal-september.org"; posting-account="U2FsdGVkX1/44isY3F8i7pbKIL2BVYEE"
User-Agent: Mozilla/5.0 (OS/2; Warp 4.5; rv:38.0) Gecko/20100101
Thunderbird/38.8.0
Cancel-Lock: sha1:DT+R+Qy0g/+bqbK4s3VC0oR4OpE=
In-Reply-To: <aqirug1jecic1kutmdc39nobvsvg05rnpd@4ax.com>
 by: Peter Moylan - Mon, 24 Jan 2022 00:06 UTC

On 24/01/22 08:41, Ruud Harmsen wrote:
> 23 Jan 2022 09:16:25 GMT: Paul Carmichael <wibbleypants@gmail.com>
> scribeva:
>
>> El Sat, 22 Jan 2022 20:28:51 +0100, Ruud Harmsen escribió:
>>
>>> 22 Jan 2022 16:50:45 GMT: Paul Carmichael
>>> <wibbleypants@gmail.com> scribeva:
>>>
>>>> El Fri, 21 Jan 2022 16:15:34 -0700, Ken Blake escribió:
>>>>
>>>>> I think it's very rare that programmers write user
>>>>> documentation for the programs they write.
>>>
>>> I always did, and still do.
>>>
>>>> They are rarely expected to.
>>>
>>> They are, and I do expect myself to.
>>
>> We are obviously from vastly different programming backgrounds.
>>
>> I have never heard of a programmer being asked to produce end-user
>> documentation. Internal - yes.
>
> I did all of it.
>
>> Big companies often have entire departments devoted to
>> documentation.
>
> Wrong approach. For me, anyway.
>
>> Unfortunately, the people that work in such departments are very
>> mobile and have little knowledge of the product.
>
> That's exactly the problem.

How the world has changed. In the (good?) old days you picked your worst
programmers, the ones who always screwed up, and moved them on to doing
documentation to limit the damage they could do.

If they were just as bad at documentation, you moved them into management.

--
Peter Moylan Newcastle, NSW http://www.pmoylan.org

Re: that I hope will ...

<mn.c0907e6196c301bc.127094@snitoo>

  copy mid

https://www.novabbs.com/interests/article-flat.php?id=111646&group=alt.usage.english#111646

  copy link   Newsgroups: alt.usage.english
Path: i2pn2.org!i2pn.org!eternal-september.org!reader02.eternal-september.org!.POSTED!not-for-mail
From: snidely....@gmail.com (Snidely)
Newsgroups: alt.usage.english
Subject: Re: that I hope will ...
Date: Mon, 24 Jan 2022 02:24:00 -0800
Organization: Dis One
Lines: 53
Message-ID: <mn.c0907e6196c301bc.127094@snitoo>
References: <8d6655bf-3d42-457a-81bf-5f8f02ef3f84n@googlegroups.com> <4e3a8fd8-1dd1-49fd-8a57-698935fe8dd7n@googlegroups.com> <tf5kugtufdrfk0q9jhr3gtcqldoidc88v1@4ax.com> <20220121095124.313aae22ce6a77b49fe4bd4f@127.0.0.1> <ssfe3t$sh4$1@dont-email.me> <k7fmug57qtibbupr3opsfro187bfnemuag@4ax.com> <pan$a6f38$594e2061$8500134c$47455847@gmail.com> <blmoug5rqie5phqp95trt6s3s4tihdprpb@4ax.com> <pan$acb34$7b7ee067$8702c558$23270bb5@gmail.com> <aqirug1jecic1kutmdc39nobvsvg05rnpd@4ax.com> <sskqim$gjq$1@dont-email.me>
Reply-To: snidely.too@gmail.com
Mime-Version: 1.0
Content-Type: text/plain; charset="iso-8859-15"; format=flowed
Content-Transfer-Encoding: 8bit
Injection-Info: reader02.eternal-september.org; posting-host="4f45ff425c819d68d30f711369fbf919";
logging-data="3730"; mail-complaints-to="abuse@eternal-september.org"; posting-account="U2FsdGVkX18XIoDDhYpCMOadvqjHrmXNStVS27c+CRE="
Cancel-Lock: sha1:C78Dq17p0X29E4ngMOn/NSo7UK4=
X-Newsreader: MesNews/1.08.06.00-gb
X-ICQ: 543516788
 by: Snidely - Mon, 24 Jan 2022 10:24 UTC

Peter Moylan pounded on thar keyboard to tell us
> On 24/01/22 08:41, Ruud Harmsen wrote:
>> 23 Jan 2022 09:16:25 GMT: Paul Carmichael <wibbleypants@gmail.com>
>> scribeva:
>>
>>> El Sat, 22 Jan 2022 20:28:51 +0100, Ruud Harmsen escribió:
>>>
>>>> 22 Jan 2022 16:50:45 GMT: Paul Carmichael
>>>> <wibbleypants@gmail.com> scribeva:
>>>>
>>>>> El Fri, 21 Jan 2022 16:15:34 -0700, Ken Blake escribió:
>>>>>
>>>>>> I think it's very rare that programmers write user
>>>>>> documentation for the programs they write.
>>>>
>>>> I always did, and still do.
>>>>
>>>>> They are rarely expected to.
>>>>
>>>> They are, and I do expect myself to.
>>>
>>> We are obviously from vastly different programming backgrounds.
>>>
>>> I have never heard of a programmer being asked to produce end-user
>>> documentation. Internal - yes.
>>
>> I did all of it.
>>
>>> Big companies often have entire departments devoted to
>>> documentation.
>>
>> Wrong approach. For me, anyway.
>>
>>> Unfortunately, the people that work in such departments are very
>>> mobile and have little knowledge of the product.
>>
>> That's exactly the problem.
>
> How the world has changed. In the (good?) old days you picked your worst
> programmers, the ones who always screwed up, and moved them on to doing
> documentation to limit the damage they could do.
>
> If they were just as bad at documentation, you moved them into management.

I've known some Psych majors who moved into managment. I happen to be
glad they weren't in my department.

/dps

--
I have always been glad we weren't killed that night. I do not know
any particular reason, but I have always been glad.
_Roughing It_, Mark Twain

Re: that I hope will ...

<fnCHJ.182018$%Gk6.17105@fx10.ams1>

  copy mid

https://www.novabbs.com/interests/article-flat.php?id=111732&group=alt.usage.english#111732

  copy link   Newsgroups: alt.usage.english
Path: i2pn2.org!i2pn.org!weretis.net!feeder8.news.weretis.net!newsreader4.netcologne.de!news.netcologne.de!peer03.ams1!peer.ams1.xlned.com!news.xlned.com!fx10.ams1.POSTED!not-for-mail
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:91.0) Gecko/20100101
Thunderbird/91.5.0
Subject: Re: that I hope will ...
Content-Language: en-GB
Newsgroups: alt.usage.english
References: <8d6655bf-3d42-457a-81bf-5f8f02ef3f84n@googlegroups.com>
<4e3a8fd8-1dd1-49fd-8a57-698935fe8dd7n@googlegroups.com>
<tf5kugtufdrfk0q9jhr3gtcqldoidc88v1@4ax.com>
<20220121095124.313aae22ce6a77b49fe4bd4f@127.0.0.1>
<ssfe3t$sh4$1@dont-email.me> <k7fmug57qtibbupr3opsfro187bfnemuag@4ax.com>
<pan$a6f38$594e2061$8500134c$47455847@gmail.com>
<blmoug5rqie5phqp95trt6s3s4tihdprpb@4ax.com>
<pan$acb34$7b7ee067$8702c558$23270bb5@gmail.com>
<aqirug1jecic1kutmdc39nobvsvg05rnpd@4ax.com> <sskqim$gjq$1@dont-email.me>
<mn.c0907e6196c301bc.127094@snitoo>
From: not...@home.com (Sam Plusnet)
In-Reply-To: <mn.c0907e6196c301bc.127094@snitoo>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 8bit
Lines: 14
Message-ID: <fnCHJ.182018$%Gk6.17105@fx10.ams1>
X-Complaints-To: abuse(at)newshosting.com
NNTP-Posting-Date: Mon, 24 Jan 2022 18:39:07 UTC
Organization: Newshosting.com - Highest quality at a great price! www.newshosting.com
Date: Mon, 24 Jan 2022 18:39:07 +0000
X-Received-Bytes: 1634
 by: Sam Plusnet - Mon, 24 Jan 2022 18:39 UTC

On 24-Jan-22 10:24, Snidely wrote:
> Peter Moylan pounded on thar keyboard to tell us

>> If they were just as bad at documentation, you moved them into
>> management.
>
> I've known some Psych majors who moved into management.  I happen to be
> glad they weren't in my department.

How did that make you feel?

--
Sam Plusnet

Re: that I hope will ...

<4ffe27e5-04af-469d-8809-bdf9c0c307f5n@googlegroups.com>

  copy mid

https://www.novabbs.com/interests/article-flat.php?id=111762&group=alt.usage.english#111762

  copy link   Newsgroups: alt.usage.english
X-Received: by 2002:a05:6214:2349:: with SMTP id hu9mr16379895qvb.93.1643057143472;
Mon, 24 Jan 2022 12:45:43 -0800 (PST)
X-Received: by 2002:a05:6902:1208:: with SMTP id s8mr9841553ybu.576.1643057143072;
Mon, 24 Jan 2022 12:45:43 -0800 (PST)
Path: i2pn2.org!i2pn.org!weretis.net!feeder6.news.weretis.net!news.misty.com!border2.nntp.dca1.giganews.com!nntp.giganews.com!news-out.google.com!nntp.google.com!postnews.google.com!google-groups.googlegroups.com!not-for-mail
Newsgroups: alt.usage.english
Date: Mon, 24 Jan 2022 12:45:42 -0800 (PST)
In-Reply-To: <d3df240c-5952-42b5-bafc-33a03595c034n@googlegroups.com>
Injection-Info: google-groups.googlegroups.com; posting-host=24.80.120.214; posting-account=Vt51bQoAAABk_nCEgVIQYp0w22eZMNlo
NNTP-Posting-Host: 24.80.120.214
References: <d3df240c-5952-42b5-bafc-33a03595c034n@googlegroups.com>
User-Agent: G2/1.0
MIME-Version: 1.0
Message-ID: <4ffe27e5-04af-469d-8809-bdf9c0c307f5n@googlegroups.com>
Subject: Re: that I hope will ...
From: bill...@shaw.ca (bil...@shaw.ca)
Injection-Date: Mon, 24 Jan 2022 20:45:43 +0000
Content-Type: text/plain; charset="UTF-8"
Lines: 20
 by: bil...@shaw.ca - Mon, 24 Jan 2022 20:45 UTC

On Thursday, January 20, 2022 at 3:53:27 AM UTC-8, hongy...@gmail.com wrote:
> See the following comment posted here by me [1]:
>
> === begin ===
> You're welcome. Based on your script, I created a new GitHub
> repository [1] that I hope will facilitate the collaborative
> development of the script and make it more accessible and usable by
> others.
> === end ===
> By language-feel, it seems that the usage of "that I hope will" is not correct/appropriate, but I don't know how to improve/touch-up it.
> Any hints will be highly appreciated.
>
I think it works as it stands, but if it feels awkward to you, try "a new GitHub
repository, which I hope will faciliate..."

bill

> [1] https://lists.quantum-espresso.org/pipermail/users/2022-January/048589.html
>
> Regards,
> HZ

Re: that I hope will ...

<20220124213840.404d9501da2cd37823a09c73@127.0.0.1>

  copy mid

https://www.novabbs.com/interests/article-flat.php?id=111777&group=alt.usage.english#111777

  copy link   Newsgroups: alt.usage.english
Path: i2pn2.org!i2pn.org!eternal-september.org!reader02.eternal-september.org!.POSTED!not-for-mail
From: adm...@127.0.0.1 (Kerr-Mudd, John)
Newsgroups: alt.usage.english
Subject: Re: that I hope will ...
Date: Mon, 24 Jan 2022 21:38:40 +0000
Organization: Dis
Lines: 19
Message-ID: <20220124213840.404d9501da2cd37823a09c73@127.0.0.1>
References: <8d6655bf-3d42-457a-81bf-5f8f02ef3f84n@googlegroups.com>
<4e3a8fd8-1dd1-49fd-8a57-698935fe8dd7n@googlegroups.com>
<tf5kugtufdrfk0q9jhr3gtcqldoidc88v1@4ax.com>
<20220121095124.313aae22ce6a77b49fe4bd4f@127.0.0.1>
<ssfe3t$sh4$1@dont-email.me>
<k7fmug57qtibbupr3opsfro187bfnemuag@4ax.com>
<pan$a6f38$594e2061$8500134c$47455847@gmail.com>
<blmoug5rqie5phqp95trt6s3s4tihdprpb@4ax.com>
<pan$acb34$7b7ee067$8702c558$23270bb5@gmail.com>
<aqirug1jecic1kutmdc39nobvsvg05rnpd@4ax.com>
<sskqim$gjq$1@dont-email.me>
<mn.c0907e6196c301bc.127094@snitoo>
<fnCHJ.182018$%Gk6.17105@fx10.ams1>
Mime-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable
Injection-Info: reader02.eternal-september.org; posting-host="0ddbe4fca7abe2119c3b0a2865a8e442";
logging-data="5467"; mail-complaints-to="abuse@eternal-september.org"; posting-account="U2FsdGVkX19yGAmwBMj985TL6C2oGTLr6tKbhZZPyYs="
Cancel-Lock: sha1:fBIXVjE1iDL4U4O3lKumQjAB2xs=
X-Newsreader: Sylpheed 3.7.0 (GTK+ 2.24.30; i686-pc-mingw32)
;X-no-Archive: Maybe
GNU: Terry Pratchett
 by: Kerr-Mudd, John - Mon, 24 Jan 2022 21:38 UTC

On Mon, 24 Jan 2022 18:39:07 +0000
Sam Plusnet <not@home.com> wrote:

> On 24-Jan-22 10:24, Snidely wrote:
> > Peter Moylan pounded on thar keyboard to tell us
>
> >> If they were just as bad at documentation, you moved them into
> >> management.
> >
> > I've known some Psych majors who moved into management.  I happen to be
> > glad they weren't in my department.
>
> How did that make you feel?
>
Eliza, is that you?

--
Bah, and indeed Humbug.

Re: that I hope will ...

<fc3a894a-3c31-4684-b212-158287b79e16n@googlegroups.com>

  copy mid

https://www.novabbs.com/interests/article-flat.php?id=111785&group=alt.usage.english#111785

  copy link   Newsgroups: alt.usage.english
X-Received: by 2002:a05:620a:29d3:: with SMTP id s19mr12804515qkp.730.1643063300654;
Mon, 24 Jan 2022 14:28:20 -0800 (PST)
X-Received: by 2002:a05:6902:1508:: with SMTP id q8mr23908471ybu.117.1643063300462;
Mon, 24 Jan 2022 14:28:20 -0800 (PST)
Path: i2pn2.org!i2pn.org!weretis.net!feeder6.news.weretis.net!news.misty.com!border2.nntp.dca1.giganews.com!nntp.giganews.com!news-out.google.com!nntp.google.com!postnews.google.com!google-groups.googlegroups.com!not-for-mail
Newsgroups: alt.usage.english
Date: Mon, 24 Jan 2022 14:28:20 -0800 (PST)
In-Reply-To: <20220124213840.404d9501da2cd37823a09c73@127.0.0.1>
Injection-Info: google-groups.googlegroups.com; posting-host=47.208.151.23; posting-account=7Xc2EwkAAABXMcQfERYamr3b-64IkBws
NNTP-Posting-Host: 47.208.151.23
References: <8d6655bf-3d42-457a-81bf-5f8f02ef3f84n@googlegroups.com>
<4e3a8fd8-1dd1-49fd-8a57-698935fe8dd7n@googlegroups.com> <tf5kugtufdrfk0q9jhr3gtcqldoidc88v1@4ax.com>
<20220121095124.313aae22ce6a77b49fe4bd4f@127.0.0.1> <ssfe3t$sh4$1@dont-email.me>
<k7fmug57qtibbupr3opsfro187bfnemuag@4ax.com> <pan$a6f38$594e2061$8500134c$47455847@gmail.com>
<blmoug5rqie5phqp95trt6s3s4tihdprpb@4ax.com> <pan$acb34$7b7ee067$8702c558$23270bb5@gmail.com>
<aqirug1jecic1kutmdc39nobvsvg05rnpd@4ax.com> <sskqim$gjq$1@dont-email.me>
<mn.c0907e6196c301bc.127094@snitoo> <fnCHJ.182018$%Gk6.17105@fx10.ams1> <20220124213840.404d9501da2cd37823a09c73@127.0.0.1>
User-Agent: G2/1.0
MIME-Version: 1.0
Message-ID: <fc3a894a-3c31-4684-b212-158287b79e16n@googlegroups.com>
Subject: Re: that I hope will ...
From: dkleine...@gmail.com (David Kleinecke)
Injection-Date: Mon, 24 Jan 2022 22:28:20 +0000
Content-Type: text/plain; charset="UTF-8"
Lines: 26
 by: David Kleinecke - Mon, 24 Jan 2022 22:28 UTC

On Monday, January 24, 2022 at 1:45:30 PM UTC-8, Kerr-Mudd, John wrote:
> On Mon, 24 Jan 2022 18:39:07 +0000
> Sam Plusnet <n...@home.com> wrote:
>
> > On 24-Jan-22 10:24, Snidely wrote:
> > > Peter Moylan pounded on thar keyboard to tell us
> >
> > >> If they were just as bad at documentation, you moved them into
> > >> management.
> > >
> > > I've known some Psych majors who moved into management. I happen to be
> > > glad they weren't in my department.
> >
> > How did that make you feel?
> >
> Eliza, is that you?
We ought IMO give token respect to Knuth's "literate programming" which
would have eliminated documenting by expanding the comments into a
narrative which included the code.

Knuth's idea is hard to implement. His own attempt to translate "Colossal
Cavern" (original in FORTRAN) is a disaster. It was a bad choice of example
because it is hard to imagine anything less documentable than CC.

But literate programming remains a feasible alternative even if nobody
uses it.

Re: that I hope will ...

<ssnffd$hlu$1@dont-email.me>

  copy mid

https://www.novabbs.com/interests/article-flat.php?id=111809&group=alt.usage.english#111809

  copy link   Newsgroups: alt.usage.english
Path: i2pn2.org!i2pn.org!eternal-september.org!reader02.eternal-september.org!.POSTED!not-for-mail
From: pet...@pmoylan.org.invalid (Peter Moylan)
Newsgroups: alt.usage.english
Subject: Re: that I hope will ...
Date: Tue, 25 Jan 2022 11:15:41 +1100
Organization: A noiseless patient Spider
Lines: 66
Message-ID: <ssnffd$hlu$1@dont-email.me>
References: <8d6655bf-3d42-457a-81bf-5f8f02ef3f84n@googlegroups.com>
<4e3a8fd8-1dd1-49fd-8a57-698935fe8dd7n@googlegroups.com>
<tf5kugtufdrfk0q9jhr3gtcqldoidc88v1@4ax.com>
<20220121095124.313aae22ce6a77b49fe4bd4f@127.0.0.1>
<ssfe3t$sh4$1@dont-email.me> <k7fmug57qtibbupr3opsfro187bfnemuag@4ax.com>
<pan$a6f38$594e2061$8500134c$47455847@gmail.com>
<blmoug5rqie5phqp95trt6s3s4tihdprpb@4ax.com>
<pan$acb34$7b7ee067$8702c558$23270bb5@gmail.com>
<aqirug1jecic1kutmdc39nobvsvg05rnpd@4ax.com> <sskqim$gjq$1@dont-email.me>
<mn.c0907e6196c301bc.127094@snitoo> <fnCHJ.182018$%Gk6.17105@fx10.ams1>
<20220124213840.404d9501da2cd37823a09c73@127.0.0.1>
<fc3a894a-3c31-4684-b212-158287b79e16n@googlegroups.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 7bit
Injection-Date: Tue, 25 Jan 2022 00:15:41 -0000 (UTC)
Injection-Info: reader02.eternal-september.org; posting-host="59e7b7bee194fd8284ab254ffeff0443";
logging-data="18110"; mail-complaints-to="abuse@eternal-september.org"; posting-account="U2FsdGVkX1+0T0wrQdgAeTX/Fxrp5H7U"
User-Agent: Mozilla/5.0 (OS/2; Warp 4.5; rv:38.0) Gecko/20100101
Thunderbird/38.8.0
Cancel-Lock: sha1:N1B25hNUlV+BCvLwUm/8dFLNmDc=
In-Reply-To: <fc3a894a-3c31-4684-b212-158287b79e16n@googlegroups.com>
 by: Peter Moylan - Tue, 25 Jan 2022 00:15 UTC

On 25/01/22 09:28, David Kleinecke wrote:
> On Monday, January 24, 2022 at 1:45:30 PM UTC-8, Kerr-Mudd, John
> wrote:
>> On Mon, 24 Jan 2022 18:39:07 +0000 Sam Plusnet <n...@home.com>
>> wrote:
>>
>>> On 24-Jan-22 10:24, Snidely wrote:
>>>> Peter Moylan pounded on thar keyboard to tell us
>>>
>>>>> If they were just as bad at documentation, you moved them
>>>>> into management.
>>>>
>>>> I've known some Psych majors who moved into management. I
>>>> happen to be glad they weren't in my department.
>>>
>>> How did that make you feel?
>>>
>> Eliza, is that you?
>
> We ought IMO give token respect to Knuth's "literate programming"
> which would have eliminated documenting by expanding the comments
> into a narrative which included the code.
>
> Knuth's idea is hard to implement. His own attempt to translate
> "Colossal Cavern" (original in FORTRAN) is a disaster. It was a bad
> choice of example because it is hard to imagine anything less
> documentable than CC.
>
> But literate programming remains a feasible alternative even if
> nobody uses it.

I wouldn't go as far as Knuth, but in my own programming I go some
direction towards giving priority to comments. In particular, when
trying to work out a suitable algorithm to do something, I'll put the
comments in first, and then try to work out code that would match the
comments.

For a simple example, consider the "shift and subtract" algorithm for
division. Nearly everyone knows what that means and how it is
implemented, but if you try to do an implementation from scratch you're
likely to get the fine details [1] wrong. (e.g. by going around the loop
the wrong number of times.) So when I've had to implement it, which I've
done several times over the years, I've first put in a loop with an
unspecified number of iterations, then put in comments that show the
loop invariants, the starting conditions, and so on. Next, I put in code
that matched the conditions shown in the comments (the loop invariants
being the most important part).

When I was teaching programming, I often had students come to me with
the question "Why doesn't my program work?". Initially I would try to
trace the logic, and I would come to a point where I would say "What
were you trying to do here?" The student usually didn't know. So, in the
end, I adopted a policy of refusing to help on uncommented code. I'd
tell them to come back after they had put in the comments. In many cases
they didn't come back, because putting in the comments had shown them
where their reasoning was faulty.

[1] Initially I mistyped that as "find details". That's not because I
have some sort of liaison in my speech. It's more a matter of my fingers
looking ahead and seeing that a 'd' will be needed soon.

But of course often we do merge words this way. WIWAL I thought the
power poles in the street were called "lamb posts".

--
Peter Moylan Newcastle, NSW http://www.pmoylan.org

Re: that I hope will ...

<mn.c4097e615bb6e951.127094@snitoo>

  copy mid

https://www.novabbs.com/interests/article-flat.php?id=111820&group=alt.usage.english#111820

  copy link   Newsgroups: alt.usage.english
Path: i2pn2.org!i2pn.org!eternal-september.org!reader02.eternal-september.org!.POSTED!not-for-mail
From: snidely....@gmail.com (Snidely)
Newsgroups: alt.usage.english
Subject: Re: that I hope will ...
Date: Mon, 24 Jan 2022 17:13:59 -0800
Organization: Dis One
Lines: 23
Message-ID: <mn.c4097e615bb6e951.127094@snitoo>
References: <8d6655bf-3d42-457a-81bf-5f8f02ef3f84n@googlegroups.com> <4e3a8fd8-1dd1-49fd-8a57-698935fe8dd7n@googlegroups.com> <tf5kugtufdrfk0q9jhr3gtcqldoidc88v1@4ax.com> <20220121095124.313aae22ce6a77b49fe4bd4f@127.0.0.1> <ssfe3t$sh4$1@dont-email.me> <k7fmug57qtibbupr3opsfro187bfnemuag@4ax.com> <pan$a6f38$594e2061$8500134c$47455847@gmail.com> <blmoug5rqie5phqp95trt6s3s4tihdprpb@4ax.com> <pan$acb34$7b7ee067$8702c558$23270bb5@gmail.com> <aqirug1jecic1kutmdc39nobvsvg05rnpd@4ax.com> <sskqim$gjq$1@dont-email.me> <mn.c0907e6196c301bc.127094@snitoo> <fnCHJ.182018$%Gk6.17105@fx10.ams1> <20220124213840.404d9501da2cd37823a09c73@127.0.0.1> <fc3a894a-3c31-4684-b212-158287b79e16n@googlegroups.com> <ssnffd$hlu$1@dont-email.me>
Reply-To: snidely.too@gmail.com
Mime-Version: 1.0
Content-Type: text/plain; charset="iso-8859-15"; format=flowed
Content-Transfer-Encoding: 8bit
Injection-Info: reader02.eternal-september.org; posting-host="204d98c54be29a4efd653bb438c1382c";
logging-data="3467"; mail-complaints-to="abuse@eternal-september.org"; posting-account="U2FsdGVkX18pR9k0AdOfrkpQxMdYuS0ciES7ukV8Ns8="
Cancel-Lock: sha1:dZTbKoZAzZDg2mQM4OXJ/wK92Gs=
X-Newsreader: MesNews/1.08.06.00-gb
X-ICQ: 543516788
 by: Snidely - Tue, 25 Jan 2022 01:13 UTC

Peter Moylan explained on 1/24/2022 :

> Nearly everyone knows what that means and how it is
> implemented, but if you try to do an implementation from scratch you're
> likely to get the fine details [1] wrong.
[...]

> [1] Initially I mistyped that as "find details". That's not because I
> have some sort of liaison in my speech. It's more a matter of my fingers
> looking ahead and seeing that a 'd' will be needed soon.
>
> But of course often we do merge words this way. WIWAL I thought the
> power poles in the street were called "lamb posts".

Merino?

-d

--
Killing a mouse was hardly a Nobel Prize-worthy exercise, and Lawrence
went apopleptic when he learned a lousy rodent had peed away all his
precious heavy water.
_The Disappearing Spoon_, Sam Kean

Re: that I hope will ...

<20220125111109.e4bf5ebb7144bde28c93e1bb@127.0.0.1>

  copy mid

https://www.novabbs.com/interests/article-flat.php?id=111875&group=alt.usage.english#111875

  copy link   Newsgroups: alt.usage.english
Path: i2pn2.org!i2pn.org!eternal-september.org!reader02.eternal-september.org!.POSTED!not-for-mail
From: adm...@127.0.0.1 (Kerr-Mudd, John)
Newsgroups: alt.usage.english
Subject: Re: that I hope will ...
Date: Tue, 25 Jan 2022 11:11:09 +0000
Organization: Dis
Lines: 22
Message-ID: <20220125111109.e4bf5ebb7144bde28c93e1bb@127.0.0.1>
References: <8d6655bf-3d42-457a-81bf-5f8f02ef3f84n@googlegroups.com>
<4e3a8fd8-1dd1-49fd-8a57-698935fe8dd7n@googlegroups.com>
<tf5kugtufdrfk0q9jhr3gtcqldoidc88v1@4ax.com>
<20220121095124.313aae22ce6a77b49fe4bd4f@127.0.0.1>
<ssfe3t$sh4$1@dont-email.me>
<k7fmug57qtibbupr3opsfro187bfnemuag@4ax.com>
<pan$a6f38$594e2061$8500134c$47455847@gmail.com>
<blmoug5rqie5phqp95trt6s3s4tihdprpb@4ax.com>
<pan$acb34$7b7ee067$8702c558$23270bb5@gmail.com>
<aqirug1jecic1kutmdc39nobvsvg05rnpd@4ax.com>
<sskqim$gjq$1@dont-email.me>
<mn.c0907e6196c301bc.127094@snitoo>
<fnCHJ.182018$%Gk6.17105@fx10.ams1>
<20220124213840.404d9501da2cd37823a09c73@127.0.0.1>
<fc3a894a-3c31-4684-b212-158287b79e16n@googlegroups.com>
<ssnffd$hlu$1@dont-email.me>
<mn.c4097e615bb6e951.127094@snitoo>
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Injection-Info: reader02.eternal-september.org; posting-host="447757a8e3248102b4cb63fa13be2eae";
logging-data="21853"; mail-complaints-to="abuse@eternal-september.org"; posting-account="U2FsdGVkX1+2SzdFCDHaNGGPAttwKzfPBMYuzV9av4k="
Cancel-Lock: sha1:2qUqesqC4WM+2Sx7vEwhV18hSHc=
X-Newsreader: Sylpheed 3.7.0 (GTK+ 2.24.30; i686-pc-mingw32)
;X-no-Archive: Maybe
GNU: Terry Pratchett
 by: Kerr-Mudd, John - Tue, 25 Jan 2022 11:11 UTC

On Mon, 24 Jan 2022 17:13:59 -0800
Snidely <snidely.too@gmail.com> wrote:

> Peter Moylan explained on 1/24/2022 :
>
> > Nearly everyone knows what that means and how it is
> > implemented, but if you try to do an implementation from scratch you're
> > likely to get the fine details [1] wrong.
> [...]
>
> > [1] Initially I mistyped that as "find details". That's not because I
> > have some sort of liaison in my speech. It's more a matter of my fingers
> > looking ahead and seeing that a 'd' will be needed soon.
> >
> > But of course often we do merge words this way. WIWAL I thought the
> > power poles in the street were called "lamb posts".
>
> Merino?
>
Android dreams.
--
Bah, and indeed Humbug.

Re: that I hope will ...

<3860vgp67ptn42varvt24ge9ecolu61ula@4ax.com>

  copy mid

https://www.novabbs.com/interests/article-flat.php?id=111928&group=alt.usage.english#111928

  copy link   Newsgroups: alt.usage.english
Path: i2pn2.org!i2pn.org!aioe.org!news.uzoreto.com!fu-berlin.de!uni-berlin.de!individual.net!not-for-mail
From: Ken...@invalid.news.com (Ken Blake)
Newsgroups: alt.usage.english
Subject: Re: that I hope will ...
Date: Tue, 25 Jan 2022 08:37:33 -0700
Lines: 43
Message-ID: <3860vgp67ptn42varvt24ge9ecolu61ula@4ax.com>
References: <k7fmug57qtibbupr3opsfro187bfnemuag@4ax.com> <pan$a6f38$594e2061$8500134c$47455847@gmail.com> <blmoug5rqie5phqp95trt6s3s4tihdprpb@4ax.com> <pan$acb34$7b7ee067$8702c558$23270bb5@gmail.com> <aqirug1jecic1kutmdc39nobvsvg05rnpd@4ax.com> <sskqim$gjq$1@dont-email.me> <mn.c0907e6196c301bc.127094@snitoo> <fnCHJ.182018$%Gk6.17105@fx10.ams1> <20220124213840.404d9501da2cd37823a09c73@127.0.0.1> <fc3a894a-3c31-4684-b212-158287b79e16n@googlegroups.com> <ssnffd$hlu$1@dont-email.me>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: quoted-printable
X-Trace: individual.net 29yU5P3j8siZbGEDFmlOwgSHBm37x3sR7yf4Z7ASSn0zClRuTv
Cancel-Lock: sha1:zUqkGfa/nUjoedcc3y2zA4tbgKE=
X-Newsreader: Forte Agent 6.00/32.1186
 by: Ken Blake - Tue, 25 Jan 2022 15:37 UTC

On Tue, 25 Jan 2022 11:15:41 +1100, Peter Moylan
<peter@pmoylan.org.invalid> wrote:

>On 25/01/22 09:28, David Kleinecke wrote:
>> On Monday, January 24, 2022 at 1:45:30 PM UTC-8, Kerr-Mudd, John
>> wrote:
>>> On Mon, 24 Jan 2022 18:39:07 +0000 Sam Plusnet <n...@home.com>
>>> wrote:
>>>
>>>> On 24-Jan-22 10:24, Snidely wrote:
>>>>> Peter Moylan pounded on thar keyboard to tell us
>>>>
>>>>>> If they were just as bad at documentation, you moved them
>>>>>> into management.
>>>>>
>>>>> I've known some Psych majors who moved into management. I
>>>>> happen to be glad they weren't in my department.
>>>>
>>>> How did that make you feel?
>>>>
>>> Eliza, is that you?
>>
>> We ought IMO give token respect to Knuth's "literate programming"
>> which would have eliminated documenting by expanding the comments
>> into a narrative which included the code.
>>
>> Knuth's idea is hard to implement. His own attempt to translate
>> "Colossal Cavern" (original in FORTRAN) is a disaster. It was a bad
>> choice of example because it is hard to imagine anything less
>> documentable than CC.
>>
>> But literate programming remains a feasible alternative even if
>> nobody uses it.
>
>I wouldn't go as far as Knuth, but in my own programming I go some
>direction towards giving priority to comments. In particular, when
>trying to work out a suitable algorithm to do something, I'll put the
>comments in first, and then try to work out code that would match the
>comments.

It's been umpteen years since I've written a program, but I used to
do much the same.

Re: that I hope will ...

<j5aorcFg9pjU1@mid.individual.net>

  copy mid

https://www.novabbs.com/interests/article-flat.php?id=111951&group=alt.usage.english#111951

  copy link   Newsgroups: alt.usage.english
Path: i2pn2.org!i2pn.org!weretis.net!feeder8.news.weretis.net!news.mixmin.net!news2.arglkargh.de!news.karotte.org!fu-berlin.de!uni-berlin.de!individual.net!not-for-mail
From: acorn...@imm.cnrs.fr (Athel Cornish-Bowden)
Newsgroups: alt.usage.english
Subject: Re: that I hope will ...
Date: Tue, 25 Jan 2022 18:03:39 +0100
Lines: 54
Message-ID: <j5aorcFg9pjU1@mid.individual.net>
References: <d3df240c-5952-42b5-bafc-33a03595c034n@googlegroups.com> <eccd2bda-0132-4015-b261-c510e0f0f5bdn@googlegroups.com> <5045ba3e-5411-436b-a4e5-31f509e0fe98n@googlegroups.com> <8d6655bf-3d42-457a-81bf-5f8f02ef3f84n@googlegroups.com> <4e3a8fd8-1dd1-49fd-8a57-698935fe8dd7n@googlegroups.com> <tf5kugtufdrfk0q9jhr3gtcqldoidc88v1@4ax.com> <20220121095124.313aae22ce6a77b49fe4bd4f@127.0.0.1> <ssfe3t$sh4$1@dont-email.me> <k7fmug57qtibbupr3opsfro187bfnemuag@4ax.com> <pan$a6f38$594e2061$8500134c$47455847@gmail.com> <blmoug5rqie5phqp95trt6s3s4tihdprpb@4ax.com> <pan$acb34$7b7ee067$8702c558$23270bb5@gmail.com> <aqirug1jecic1kutmdc39nobvsvg05rnpd@4ax.com> <sskqim$gjq$1@dont-email.me> <mn.c0907e6196c301bc.127094@snitoo> <fnCHJ.182018$%Gk6.17105@fx10.ams1> <20220124213840.404d9501da2cd37823a09c73@127.0.0.1> <fc3a894a-3c31-4684-b212-158287b79e16n@googlegroups.com> <ssnffd$hlu$1@dont-email.me> <3860vgp67ptn42varvt24ge9ecolu61ula@4ax.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 8bit
X-Trace: individual.net VpIOp/H/54g//kzdlphNcgl8gBxhBvbhN5c07g/gqRbAS+bOrM
Cancel-Lock: sha1:sB2WXOf/5zhUclaICyg/3C4MpR4=
User-Agent: Unison/2.2
 by: Athel Cornish-Bowden - Tue, 25 Jan 2022 17:03 UTC

On 2022-01-25 15:37:33 +0000, Ken Blake said:

> On Tue, 25 Jan 2022 11:15:41 +1100, Peter Moylan
> <peter@pmoylan.org.invalid> wrote:
>
>> On 25/01/22 09:28, David Kleinecke wrote:
>>> On Monday, January 24, 2022 at 1:45:30 PM UTC-8, Kerr-Mudd, John
>>> wrote:
>>>> On Mon, 24 Jan 2022 18:39:07 +0000 Sam Plusnet <n...@home.com>
>>>> wrote:
>>>>
>>>>> On 24-Jan-22 10:24, Snidely wrote:
>>>>>> Peter Moylan pounded on thar keyboard to tell us
>>>>>
>>>>>>> If they were just as bad at documentation, you moved them
>>>>>>> into management.
>>>>>>
>>>>>> I've known some Psych majors who moved into management. I
>>>>>> happen to be glad they weren't in my department.
>>>>>
>>>>> How did that make you feel?
>>>>>
>>>> Eliza, is that you?
>>>
>>> We ought IMO give token respect to Knuth's "literate programming"
>>> which would have eliminated documenting by expanding the comments
>>> into a narrative which included the code.
>>>
>>> Knuth's idea is hard to implement. His own attempt to translate
>>> "Colossal Cavern" (original in FORTRAN) is a disaster. It was a bad
>>> choice of example because it is hard to imagine anything less
>>> documentable than CC.
>>>
>>> But literate programming remains a feasible alternative even if
>>> nobody uses it.
>>
>> I wouldn't go as far as Knuth, but in my own programming I go some
>> direction towards giving priority to comments. In particular, when
>> trying to work out a suitable algorithm to do something, I'll put the
>> comments in first, and then try to work out code that would match the
>> comments.
>
>
> It's been umpteen years since I've written a program, but I used to
> do much the same.

In my Fortran days I used a lot of comments, but in Pascal I found most
could be rendered unnecessary by using names for procedures etc. that
made it obvious what their purposes were.

--
Athel -- French and British, living mainly in England until 1987.

Re: that I hope will ...

<pan$d6258$6b66f5a0$fbb7e47d$5c83195b@gmail.com>

  copy mid

https://www.novabbs.com/interests/article-flat.php?id=112078&group=alt.usage.english#112078

  copy link   Newsgroups: alt.usage.english
Path: i2pn2.org!i2pn.org!weretis.net!feeder8.news.weretis.net!3.eu.feeder.erje.net!feeder.erje.net!fu-berlin.de!uni-berlin.de!individual.net!not-for-mail
From: wibbleyp...@gmail.com (Paul Carmichael)
Newsgroups: alt.usage.english
Subject: Re: that I hope will ...
Date: 26 Jan 2022 10:45:42 GMT
Lines: 33
Message-ID: <pan$d6258$6b66f5a0$fbb7e47d$5c83195b@gmail.com>
References: <k7fmug57qtibbupr3opsfro187bfnemuag@4ax.com>
<pan$a6f38$594e2061$8500134c$47455847@gmail.com>
<blmoug5rqie5phqp95trt6s3s4tihdprpb@4ax.com>
<pan$acb34$7b7ee067$8702c558$23270bb5@gmail.com>
<aqirug1jecic1kutmdc39nobvsvg05rnpd@4ax.com> <sskqim$gjq$1@dont-email.me>
<mn.c0907e6196c301bc.127094@snitoo> <fnCHJ.182018$%Gk6.17105@fx10.ams1>
<20220124213840.404d9501da2cd37823a09c73@127.0.0.1>
<fc3a894a-3c31-4684-b212-158287b79e16n@googlegroups.com>
<ssnffd$hlu$1@dont-email.me> <3860vgp67ptn42varvt24ge9ecolu61ula@4ax.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Trace: individual.net gjEht6uAzY0RXK7EahQOQgBu6cRmcF//fwXTqohQnv0GlRrn4=
Cancel-Lock: sha1:1gB/1x91hR7t8P4oKV+yRec3aK8=
User-Agent: Pan/0.147 (Sweet Solitude; 97d1711 github.com/GNOME/pan.git)
 by: Paul Carmichael - Wed, 26 Jan 2022 10:45 UTC

El Tue, 25 Jan 2022 08:37:33 -0700, Ken Blake escribió:

> On Tue, 25 Jan 2022 11:15:41 +1100, Peter Moylan
> <peter@pmoylan.org.invalid> wrote:

>>I wouldn't go as far as Knuth, but in my own programming I go some
>>direction towards giving priority to comments. In particular, when
>>trying to work out a suitable algorithm to do something, I'll put the
>>comments in first, and then try to work out code that would match the
>>comments.
>
>
> It's been umpteen years since I've written a program, but I used to do
> much the same.

A block comment with a complete flow-chart showing all possible code
paths generally works.

How many major bugs have been caused by an unexpected code path?

The code can be debugged by somebody else and "missing" code paths /
error conditions added.

Just before I left my programming job, they were adding SEH all over the
place. Lazy bastards. Why not just code it right?

--
Paul.

https://paulc.es/elpatio


interests / alt.usage.english / Re: that I hope will ...

Pages:12
server_pubkey.txt

rocksolid light 0.9.81
clearnet tor