Xref: utzoo comp.sys.amiga.misc:167 comp.sys.amiga.advocacy:173 Path: utzoo!censor!geac!torsqnt!news-server.csri.toronto.edu!cs.utexas.edu!swrinde!zaphod.mps.ohio-state.edu!usc!apple!vsi1!zorch!xanthian From: xanthian@zorch.SF-Bay.ORG (Kent Paul Dolan) Newsgroups: comp.sys.amiga.misc,comp.sys.amiga.advocacy Subject: Re: Coding in English Message-ID: <1991Jan20.023612.14976@zorch.SF-Bay.ORG> Date: 20 Jan 91 02:36:12 GMT References: <747@cbmger.UUCP> <8179@ucdavis.ucdavis.edu> <755@cbmger.UUCP> Followup-To: comp.sys.amiga.advocacy Organization: SF-Bay Public-Access Unix Lines: 55 zerkle@iris.ucdavis.edu (Dan Zerkle) writes: > This leads to a very serious problem with documenting commercial > software. The people who wrote the programs can not write English > well. The people who can write English well can not understand the > computer programs. This means that the manuals for programs are either > incomprehensible (if the programmers write them) or wrong (if writers > are hired for the manuals). peterk@cbmger.UUCP (Peter Kittel GERMANY) responds: > Just to assure you: This is nothing special for English. Here in > Germany it's the same mess. What annoys me most is that computer > magazines here tend to totally forget about rules of how to write > texts. They even are going to use much of English grammar in German > texts which leads to really horrible results. Worst is with > punctuation rules. They differ heavily from the English ones, but now > more and more German texts appear with commas set after English rules. > Pure horror! > From that you can conclude that they are able to read English > documentation, but then they aren't able to convert this into real > German. So this should be an even worse situation than in English > speaking countries. And in a horrible burst of jingoism (note the followup!) I chip in: When computer programming first spread outside the Anglophon nations, the situation was the same as for the airlines and the ships and other communications needs that were no respectors of national borders; programming was done, and spoken of, and documented, in English, so that we wouldn't be involved in a Babel of diverse languages when porting software. Now, Amiga UUCP-Plus is available, but you'd better know the author's native tongue if you want to read the docs; you can get a great PD TeX, and the docs will show up, someday. You can get Unix lharc, and the docs are almost in English, but they throw in the Japanese ones for those who really want to understand the software. I liked it better when the whole world was busy trying to speak _my_ language. Maybe a little kick-ass war will bring English back to respectability. Probably a smiley should be in there someplace, but I learned German, Latin, and Spanish, and I still want to see the code and docs and even commentary in English, damnit. Kent, the man from xanth. -- ONE world requires ONE language. We can't afford to keep giving scholarships to proto-dictators so they can later understand CNN while they rape and pillage.