It’s also British slang for annoying.

I just looked up something in the online documentation for PHP. Pages are generally clean and usable as they appear in the browser, although there are a few poor practices if you look at the underlying HTML.

However. Take a look at a typical page. Below each formal section are (often useful) comments. Try moving the focus down the page different ways—scrolling, moving the mouse, page down. One comment at a time appears in dark colors. The other comments are pale and washed out until you move the focus to them. Then, over 0.4 seconds, they become opaque and readable.

And most of the goodwill from how well thought-out the rest is is squandered.

There is no reason to make text unreadable. And less still to waste the user’s time as they’re made readable.

Since transitions are new to CSS3, my guess is that programmers were playing. As they had in 1994 with <blink>.

Playing is fine.

Then someone in the room has to say it’s great to know we can do this if we ever need it. But we don’t now. So take it out.

I remember one program. What they used to call dusty deck, after the deck of punched cards they were on. Dusty from years sitting on a shelf. It had one constant for two very different purposes. The equivalent of using foo for both the range of values for the month and for the hour in a date-time because they both happen to be 12. Lots of luck in Israel, where the Hebrew calendar (1..13) and military time (0..23) are often used.

Your intentions should always be clear to the engineer who has to work on your code after you. Or port it to another language or another operating system. And to the compiler that has to generate valid instructions.

Don’t rely on implicit type conversion, with the possible exception of upsizing, e..g., upsizing an int to a long.

Your programming language might have standardized rules for what happens if you write 7 + "5". Which, by the way, may not be the same as if you write "7" + 5. Don’t rely on this without an awfully good reason. That it works now is no guarantee it works everywhere and everywhen or will be obvious to whoever looks at your code.

Don’t rely on how an empty string or a zero or NULL pointer is treated in a Boolean context. Explicitly convert it to Boolean so that your intent is clear and your code isn’t dependent on language minutiae. You need to know what if (object) does, if only because the language has idioms other people will use. But if (object != NULL) is clearer.

Like most rules, there are exceptions, and it’s a judgment call. If the language generates a Boolean value for a || b, then you might as well make it a || bool(b).

But if the result of || is the actual value of the first operand that doesn’t evaluate to FALSE, then you have the useful idiom:

result = maybe_empty || "default value";

Which is more graceful than:

result = (object != NULL) ? object : "default value";

Also, if you’re working on code that follows an established style, follow the style not the rule. There’s a higher rule: Standard is better than better.

Delegation is a basic principle of engineering. Do what you need and don’t tell you the details.

But sometimes you need the details.

Would you like me to arrange for someone to pick you up? It would be my pleasure. Did I not mention that we’ll charge your account $2,500 for the service? I’m sorry, but you should have asked.

It’s very convenient if you can invoke a remote procedure call as if it were a local call to a page in memory. Or access a file across the Internet with the same fopen() call as you’d use for one on an attached hard disk.

Not so much as the cost rises a thousand- or a billion-fold.

A great deal of effort has gone into trying to shield programmers from learning the data definition, manipulation, stored procedure, and query languages of the DBMS their system is built on.

Why bother? They’re not that hard to learn and get good at.

More importantly, there are common situations where switching from shipping the data across to analyze in your program and analyzing it in a stored procedure within a database server process drops the cost in network traffic from terabytes to a few KB.

Don’t bend down to pick up pennies. But understand the implications of what you do well enough to know if there’s serious money involved.

If you haven’t, be aware that GNU Emacs is a very powerful text editor that probably runs on any computer you’ve ever edited a file on or ever will. Although calling it a text editor is a profound understatement. It could as easily be considered a software development environment (IDE), an office suite, or a personal information manager (PIM).

Learning GNU Emacs, 3rd Edition is an excellent way to get started. Yes, the book was last revised in 2004. But even the 1991 first edition is still useful—one of the strengths of Emacs is that the basics are stable.

For that matter, the commands I learned ten years before that still work. I have been using some form of Emacs for over thirty years. As a tool, it’s an old reliable. With a handle worn down to comfortably fit my hand perfectly. I’ll bring it up here when I think of something to share that’s especially useful or satisfying.

One problem is terminology. Emacs has different terms and notation than you may be used to. Although, like Time Lords, we were there first. I’ll elaborate as we go. But a few essentials first.

Every one of the thousands of commands available has a name. The command to move to the previous line is called previous-line. As such, you can run it by <Esc> x previous-line <Enter>. Since it’s frequently used, and you’d never get any work done if you had to type all that, it comes bound to the key-combination <Ctrl>+p. And if your keyboard has arrow keys, it’s also bound to ↑.

If you don’t like that, you can change it. Switch the key-combination to something easier for you to remember. Or take a command you use often that doesn’t have a key-combination and assign it to one.

When discussing Emacs, though, refer to the standard key assignments. And remember, a command’s real name is the text version, not the key assignment.

Also, the way key assignments are written are different. C-p is what PC users know as <Ctrl>+p. S-p is <Shift>+p. M-p is <Alt>+p. (The M is for ‘meta.’)

And they can be combined: C-S-p, C-M-p, M-S-p, or C-M-p, or even C-M-S-p.

If you’re ever confused, the command M-x apropos helps you find commands whose name includes your search term, e.g. searching on capitalize reports capitalize, capitalize-region, capitalize-word, capitalized-words-mode, and cua-capitalize-rectangle. You can even search by regular expression if you feel like showing off.

The command M-x describe-key (bound by default to C-h k) tells you what, if anything, a key or key/mouse combination will do. After entering the command, you’ll be prompted to use the key or mouse/key combination you’re curious about. But be aware that describe-key distinguishes between the different keys that have the same labels.

For example, the * above the 8 in the main keyboard is considered a different key from the * that’s on a numeric keypad (where its Emacs name is kp-multiply). I’ve chosen to use the keypad keys for different purposes, e.g., in my setup the keypad’s * inserts a • instead of an asterisk.