It is implying that adding odd mysteries to the documentation would engage the readers curiosity and make them read it more carefully than they otherwise would With the trick being that the odd structure may not be solvable and it's only reason for inclusion was to make the reader take interest.
The enlightenment comes when you spot the trick and realized you now know more about an otherwise boring subject than you would have had you only skimmed the manual.
Same here, and curiously as to how GP phrased it, I did skim it the first time - only upon reading the ending I was prompted to re-read the whole story properly.
It’s a shame that there aren’t really anyone in the same vein as Douglas Adams (clever, witty, enthusiastic when he wants and cutting when he needs, and overpoweringly nerdy).
Reading some of his articles the other day (written for MacUser), there was no negativity, no angst, no flame war (but a healthy dose of irony); just pure enthusiasm about the cool new things we could do with the cool new computers and assorted gizmos. We could use more of that.
flicking through the article i saw mention of the "reset" button on the keyboard - this was my least favourite feature of the 8-bit computers such as the apple ][ and the bbc micro - one slip of your finger often meant lost work. actually having a reset button was a good thing - just don't put it on the keyboard.
On the original Apple ][, the reset key was indeed just a regular key that was easy to press. On later models (the ][ plus, I think) Apple used a spring for the reset key that required a higher force to depress it. Finally, on the Apple //e, you had to press Control+Open Apple+Reset to reset the machine... but I have no idea if Franklin did anything special to the reset key on their Apple clone.
It was just ctrl-reset for the reset button. Ctrl-open apple-reset was a hard reboot. But since open apple was aliased to one of the paddle buttons, you could accidentally trigger a hard reboot if you happened to have something sitting on top of the paddles that you weren’t using.
yes, i think that the trend was to make it harder to reset, but why not simply have a reset switch? my dragon32 (6809 processor) has one on the back and the research machines 380zs (z80 processor) had an illuminated switch on the front of the steel case of the brute, which reset and dumped you into the front panel/machine-code debugger. oh, those happy days.
The RESET key is so well-hidden it's not even visible in the first picture. In the second picture, you can see the notch along the back of the keyboard near the numeric keypad. In the third picture, with the cover removed, you can how the key extends backward at a perpendicular angle.
You're never going to hit that thing by mistake. You might not even realize it exists until someone points it out to you.
On the first Mac, you had to attach the hardware for the reset ‘key’ yourself, if you wanted one. See photo “3 of 3” on https://americanhistory.si.edu/collections/search/object/nma... for the part you had to insert. The two ‘prongs’ reached two switches for NMI and reset inside the Mac.
It's worth pointing out that this was very much by design. Reset on the Apple II was a warm reset. It provided the ability to break out of a hung, spinning or otherwise misbehaving program and get back to the boot-time monitor prompt in a state where your live in-memory work wasn't lost.
Remember the original computer didn't have a disk yet. The only storage was a cassette tape operating at 6000 baud. You didn't hack on it by editting a text file and then compiling it from storage, you programmed in-memory (either in BASIC or by hand-assembling instructions at the monitor). Then you tried it, and if it worked you started worrying about how to get that pickled to storage in a recoverable way.
It was a different world, and "reset" was absolutely a critical feature.
But yeah, fast forward a few years and the median user was "running" software and not writing it, and we all forgot about why it was there.
That was a nice feature of the Atari 800. Reset button is off to the side away from the keyboard. With little plastic risers / borders above and below it to further reduce the chance of accidentally hitting it. Even though I was a very clumsy kid, I don't think I ever inadvertently reset it. Which means it worked well in my sample size of 1.
The BBC Microcomputer had an "Escape" key and a potentially misleadingly named "Break" key - but "Break" was actually more like a reset key (with CTRL-Break being a "harder" reset and SHIFT-Break prompting the computer to boot off a floppy disk).
But one nice feature was that if you were simply programming in BASIC and immediately typed OLD after hitting "Break", you had a chance of recovering your program if you weren't unlucky.
And the other feature which this comment reminded me of - at least some models of the BBC Micro had a hardware lock on the "Break" key, so with a small screwdriver you could turn a little piece of plastic to completely prevent the key being pressed!
I sense, possibly, that while this manual is weird and charming to us, it might have been highly frustrating to the audience it thought it was writing for. I’ve sometimes found that there’s a big difference between a “beginner” and “an engineer’s idea of a beginner.” That might explain all their “tone down” changes in the later version.
The Apple manuals also had a sense of whimsy about them as well. I learned “defenestrate” from the glossary at the back of one of the Apple ][ manuals. I also seem to remember other jokes scattered throughout the manual including the index.
It is funny in the context of a glossary otherwise composed of computer terms. Their definition, incidentally, was “to throw something or someone out of a window.”
“Never trust a computer you can't throw out a window” is a famous Woz quote. It is not really surprising to have something along those lines in an Apple ][ manual.
I had a very early Apple //e (purchased 1983) and remember some funny things in the manuals. There was a glossary entry for Write-Only Memory. This contained an entire brief story about how it had been invented by a Prof. Farnsfarfle(?) and subsequently used to store some huge amount of surplus government data.
One of the Netscape Navigator manuals was fairly entertaining as well. Had to explain what the internet was as well. I mainly remember a Northern Exposure reference.
It must be fun (and also profitable) to design a microcomputer back in the 80s. You can feel the love poured into even a copycat product. The early gaming consoles too I guess. Nowadays only a few companies can afford that pleasure. I wish modern 8/16-bit machines could bring back the homebrew glory but apparently they are still quite niche.
I'm going to add that I don't think Rpi is a good substitution for 8/16 bit machines. It's difficult to go to the bottom of things (except for Pico) and when you do go to the bottom it is too complicated to wrap your head around it. 8/16-bit machines such as NES/Apple/SNES/8086 are easier to "digest". I read on HN that some good console programmers can map the whole memory into his brain.
Resource constraint is really a boon, not a curse.
You can have all sorts of fun with an ESP32 or Teensy. They're cheap 32 bit microcontrollers with very high clock speeds and can emulate an 8 bit microprocessor but also have a nice SDK and run a real OS (FreeRTOS). Also https://mega65.org/
You are extremely unrealistic and I don't believe it will be fine for one second if they express frustration and quit, because you will be resentful that they didn't appreciate your plan. I started with even older machines, 8 bit, and I can tell you right now a 386 or even a 486 is not realistic. You seriously propose to sit them in front of a CRT and expect them to teach themselves Pascal and to find something useful to do with it on an antique? It'll be a challenge on its own to find new floppy disks.
If you want them to enjoy what they're doing, you can show them something else more modern and useful like maybe how to use the GPIO pins on a Raspberry Pi or something to turn things on or off. If you make computing into a weird punishment all you'll end up achieving is guaranteeing disappointment.
I don't know why you call it punishment. My plan is to use a similar machine side by side. I'll definitely go over the basics with them. And there are going to be some game floppies for fun. There are still 3.5 around and I can buy an external drive to write games in on my personal laptop.
Since this is the first computer he encounters, he doesn't have anything easier to compare with. As I said if he frustrates out then it's fine, I'll give him maybe a Rpi then, nothing big deal, but if he can grit through the initial period I prepare to teach him QuickBasic first and then C if he is interested, all about game programming. It was the way kids in the 80s learned programming and I think the only obstacle is his lack of interest/intelligence and access to easier electronics.
So, since you have a limited window to work with where the kid can't see how the modern world is today, this will be a 2 year old learning basic and/or C on a 486? Their brains aren't ready for that kind of cognitive development at that age. You were a lot older back in the 80s and weren't exposed to people or society with much better stuff. Kid is going to see that dad forces them to use a 33 year old machine with poor resolution graphics and sound and is slow as molasses.
Let me frame this differently. Your father or grandfather cut the grass with a sickle. Why aren't you doing the same thing? You can buy a sickle even now. Yet, you presumably use an electric or gas mower. Why not a sickle?
Because a sickle sucks and it was fine for the time. Not now.
PS. After a kid has frustrated out, it's already too late. You're never getting them back because they've already decided they hate it. Lots and lots of kids with parents who wanted to live through them again or wanted them to be a clone of the parent, and these kids rebelled against their planned lives. Same thing with parents who force their kids to eat a food that they've already expressed that they do not like the taste of it. They don't suddenly start liking the food when they are older. Listen to what they're saying, don't force it. This isn't the army.
You have a point. I need to think through about this experiment. I still hope he has a chance to touch at least some of the lower level stuffs at the beginning though. Also I won't start from two years old for sure, probably from 8/9 just as I did. It could be still too early so I need to observe his progress.
I was sold on the Teensy after seeing an incredible synthesizer someone created with it. So much power in such a tiny and affordable package. It’s pretty incredible what we can do with so little at the moment. Maybe it’s been this way for a while — I’m just discovering the world of microcontrollers over the last couple of years.
For another example of a manual that employs humor, check out the Tigerfibel. This is the users manual for the Tiger tank, and is easily one of the most effectively designed books ever. As well as humor, it employs comic book style drawings next to photos, poetry, analogy and even a bit of nudity.
There are lots of great little training films from the past. In WWII especially they had to bring in a lot of people with little experience with the sophisticated new technologies that were often only developed during the war. Search Youtube for phrases like "world war II training films".
Some examples:
https://youtu.be/gwf5mAlI7Ug - (Mechanical Computers) U.S. NAVY BASIC MECHANISMS OF FIRE CONTROL COMPUTERS MECHANICAL COMPUTER INSTRUCTIONAL
I would have never expected a tank training manual to have so many naked breasts. Otoh given the audience at the time were young men in their prime this method of stimulating the reader is kind of obvious.
I recall there was a whole paragraph written about the sound command and that 20Hz was the resonant frequency of a chicken's head, discovered empirically.
Borland did seem to be a playful company in contrast to Microsoft, their main rival.
Reminds me of some early Bungie games, which would have files called 'DONT_EVER_READ_THIS_FILE.txt", or something to that effect. The files, of course, were the readme files, named that way to trick people into reading them.
The Franklin Ace 1000 was my first computer. I already used Apples at school, and it was just an Apple clone. Between that and the general "if all else fails, read the instructions" attitude that my Dad had already passed on to me, I don't recall recall looking at the manual very much.
Heh, we had a Franklin Apple II clone in high school (in the Netherlands). It's what the pupils who had graduated from using the Newbrain class computers were allowed to use. Not that we got access to the manual, of course.
At first, computer lessons were, of course, given by the maths teachers, but they got bored with the things, and then Dutch language teachers took over, with rather more success.
(I ended up writing a school results tracking database for the Franklin computer, and after that, the computer was moved into the office, and I never saw it again.)
US copyright law still explicitly permits copying programs you lawfully acquired for backup and use.
Frankly it’s not clear to me how that interacts with the anti-circumvention clause of the DMCA, but most software licenses are based on an outright lie: that you need a license to load the program into memory and execute it after having legally acquired the code.
On page 10, there is a suggestion to enter "STUERBPORAIYSIES!", then enable double-size mode. I can't find any reference for that anywhere. I wonder what it does?
It looks like in double-size mode, every other character is dropped. The manual text hints at the result. "Something strange? Well, just for fun, press CLEAR then type STUERBPORAIYSIES. Now press SHIFT ->. Surprised?"
The North American owner's manual for the BMW E30, which being an 80s car would have been contemporary with the Franklin Ace, has a similar humorous admonition:
> Caution: Although the ABS is very effective, always remember that braking capability is limited by tire traction. Always adjust your driving speed according to the road and traffic conditions. Do not let the extra safety afforded by the ABS tempt you taking extra risk. The ABS cannot overcome the laws of physics.
111 comments
[ 2.4 ms ] story [ 194 ms ] threadhttp://www.thecodelesscode.com/case/66
The enlightenment comes when you spot the trick and realized you now know more about an otherwise boring subject than you would have had you only skimmed the manual.
Reading some of his articles the other day (written for MacUser), there was no negativity, no angst, no flame war (but a healthy dose of irony); just pure enthusiasm about the cool new things we could do with the cool new computers and assorted gizmos. We could use more of that.
Check out the pictures here: https://deskthority.net/viewtopic.php?t=17354
The RESET key is so well-hidden it's not even visible in the first picture. In the second picture, you can see the notch along the back of the keyboard near the numeric keypad. In the third picture, with the cover removed, you can how the key extends backward at a perpendicular angle.
You're never going to hit that thing by mistake. You might not even realize it exists until someone points it out to you.
Remember the original computer didn't have a disk yet. The only storage was a cassette tape operating at 6000 baud. You didn't hack on it by editting a text file and then compiling it from storage, you programmed in-memory (either in BASIC or by hand-assembling instructions at the monitor). Then you tried it, and if it worked you started worrying about how to get that pickled to storage in a recoverable way.
It was a different world, and "reset" was absolutely a critical feature.
But yeah, fast forward a few years and the median user was "running" software and not writing it, and we all forgot about why it was there.
But one nice feature was that if you were simply programming in BASIC and immediately typed OLD after hitting "Break", you had a chance of recovering your program if you weren't unlucky.
And the other feature which this comment reminded me of - at least some models of the BBC Micro had a hardware lock on the "Break" key, so with a small screwdriver you could turn a little piece of plastic to completely prevent the key being pressed!
[1] https://en.wikipedia.org/wiki/Defenestrations_of_Prague
Defenestrate works for objects as well.
I'm going to add that I don't think Rpi is a good substitution for 8/16 bit machines. It's difficult to go to the bottom of things (except for Pico) and when you do go to the bottom it is too complicated to wrap your head around it. 8/16-bit machines such as NES/Apple/SNES/8086 are easier to "digest". I read on HN that some good console programmers can map the whole memory into his brain.
Resource constraint is really a boon, not a curse.
If you want them to enjoy what they're doing, you can show them something else more modern and useful like maybe how to use the GPIO pins on a Raspberry Pi or something to turn things on or off. If you make computing into a weird punishment all you'll end up achieving is guaranteeing disappointment.
Since this is the first computer he encounters, he doesn't have anything easier to compare with. As I said if he frustrates out then it's fine, I'll give him maybe a Rpi then, nothing big deal, but if he can grit through the initial period I prepare to teach him QuickBasic first and then C if he is interested, all about game programming. It was the way kids in the 80s learned programming and I think the only obstacle is his lack of interest/intelligence and access to easier electronics.
Let me frame this differently. Your father or grandfather cut the grass with a sickle. Why aren't you doing the same thing? You can buy a sickle even now. Yet, you presumably use an electric or gas mower. Why not a sickle?
Because a sickle sucks and it was fine for the time. Not now.
PS. After a kid has frustrated out, it's already too late. You're never getting them back because they've already decided they hate it. Lots and lots of kids with parents who wanted to live through them again or wanted them to be a clone of the parent, and these kids rebelled against their planned lives. Same thing with parents who force their kids to eat a food that they've already expressed that they do not like the taste of it. They don't suddenly start liking the food when they are older. Listen to what they're saying, don't force it. This isn't the army.
They are filled with cartoons and jokes.
https://en.wikipedia.org/wiki/Tigerfibel
https://archive.org/details/Der-Generalinspekteur-der-Panzer...
Some examples:
https://youtu.be/gwf5mAlI7Ug - (Mechanical Computers) U.S. NAVY BASIC MECHANISMS OF FIRE CONTROL COMPUTERS MECHANICAL COMPUTER INSTRUCTIONAL
https://youtu.be/s1i-dnAH9Y4 - (Mechanical Computers) Basic Mechanisms In Fire Control Computers
https://www.youtube.com/playlist?list=PL9cQ2Ddo6YCwNcDh15h2I... - Mechanical Computers (navy series)
https://youtu.be/yYAw79386WI - Around The Corner - How Differential Steering Works (1937)
https://youtu.be/ezRP1h6x2GE - Vintage training film - Manhandling - 1962
https://youtu.be/-34vk-rahPk - BODY SEARCH | Spy Training Film (Vintage, ca. 1942-1945)
https://youtu.be/acGXBJv6AT4 - Vacuum Tubes 1943 Training Film (The TRIODE) Signal Corps Army Air Force Radio
https://youtu.be/0OmOQs0ziSU - 16 Inch Gun Training Film (1955)
Better quality here: https://www.youtube.com/watch?v=xzS5xdSeS10
Borland did seem to be a playful company in contrast to Microsoft, their main rival.
At first, computer lessons were, of course, given by the maths teachers, but they got bored with the things, and then Dutch language teachers took over, with rather more success.
(I ended up writing a school results tracking database for the Franklin computer, and after that, the computer was moved into the office, and I never saw it again.)
Frankly it’s not clear to me how that interacts with the anti-circumvention clause of the DMCA, but most software licenses are based on an outright lie: that you need a license to load the program into memory and execute it after having legally acquired the code.
Found it: https://archive.org/details/Getting_Started_with_TRS-80_Basi...
> Caution: Although the ABS is very effective, always remember that braking capability is limited by tire traction. Always adjust your driving speed according to the road and traffic conditions. Do not let the extra safety afforded by the ABS tempt you taking extra risk. The ABS cannot overcome the laws of physics.
Is this the cute part? My car's manual from 2015 has practically the same wording, and it looks more like a fact than a joke or reference.
The last category of crooks is under the heading “Us”:
I wonder if the capitalisation "US" was also a deliberate reference.