[Debian-eeepc-devel] [patch] proposal: /etc/acpi/lib/notify.sh

[Trent W. Buck]

Bob Wilkinson <bob at fourtheye.org> writes:

> I am not as concerned about the size of code as I am about
> legibility and ease of comprehension.
>
> I think that to name the positional parameters at the start of the
> function produce code which is much more readable.

For sh functions shorter than a paragraph, I normally adopt Forthesque
notation, e.g.

    sieve () {                  # from to [test] -- results
        ...
    }

...and use positional parameters thereafter.  Page-long functions are,
of course, another matter.