[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: manual: Why use 'maude' as the example program name?

From: NightStrike
Subject: Re: manual: Why use 'maude' as the example program name?
Date: Wed, 28 Feb 2018 15:57:39 -0500

On Wed, Feb 28, 2018 at 11:59 AM, Gavin Smith <address@hidden>

> On 25 February 2018 at 19:13, Jonas Thiem <address@hidden> wrote:
> > Disclaimer: I haven't read this part of the docs myself. But for what
> > it's worth, I think Maude looks a bit like a misspelling of Make and
> > doesn't stick out that well, compared to "exampleprog" or something.
> > Also, I personally would suggest it's good if it's obvious from the name
> > what it is, and what it's not. (e.g. Maude could be mistaken as a
> > reference to an actual tool or some technical term the reader might
> > think they have missed) Not saying it needs to be changed, just throwing
> > in another impression.
> I changed it from "maude" to "program" in my (unofficial) attempt at
> editing the automake manual:
> Library-Variables.html#Program-and-Library-Variables
> I've no current plans to push this rewrite further but maybe someone
> will want to use some parts of it. One of my goals was to remove any
> sense of personality from the documentation so that it was as boring
> as possible, in order to focus on the subject without any
> distractions.

I actually found that the lighthearted nature of the automake manual makes
it easier to digest and understand what is otherwise overly dry material.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]