Tidying

docs/jargon.html

@@ -18,7 +18,7 @@ Free Documentation License".
       </p>
       <H2>Generated</H2>
       <p>
-This file last generated Monday, 24 December 2018 12:25PM UTC
+This file last generated Monday, 24 December 2018 12:57PM UTC
 
       </p>
       <H2>Glossary</H2>
@@ -543,7 +543,7 @@ This file last generated Monday, 24 December 2018 12:25PM UTC
 <p>4. Of a person, someone whose directions are incomprehensible and vague, but who nevertheless has the expectation that you will solve the problem using the specific method he/she has in mind. Warren Teitelman originally wrote DWIM to fix his typos and spelling errors, so it was somewhat idiosyncratic to his style, and would often make hash of anyone else's typos if they were stylistically different. Some victims of DWIM thus claimed that the acronym stood for Damn Warren s Infernal Machine!'. In one notorious incident, Warren added a DWIM feature to the command interpreter used at Xerox PARC. One day another hacker there typed delete *$ to free up some disk space. (The editor there named backup files by appending $ to the original file name, so he was trying to delete any backup files left over from old editing sessions.) It happened that there weren't any editor backup files, so DWIM helpfully reported *$ not found, assuming you meant 'delete *'. It then started to delete all the files on the disk! The hacker managed to stop it with a Vulcan nerve pinch after only a half dozen or so files were lost. The disgruntled victim later said he had been sorely tempted to go to Warren's office, tie Warren down in his chair in front of his workstation, and then type delete *$ twice. DWIM is often suggested in jest as a desired feature for a complex program; it is also occasionally described as the single instruction the ideal computer would have. Back when proofs of program correctness were in vogue, there were also jokes about DWIMC (Do What I Mean, Correctly). A related term, more often seen as a verb, is DTRT (Do The Right Thing); see Right Thing.</p>
         <H4>Datamation</H4>
         <p>
-        /day`t@maysh@n/ , n. A magazine that many hackers assume all suits read. Used to question an unbelieved quote, as in Did you read that in Datamation?. It used to publish something hackishly funny every once in a while, like the original paper on COME FROM in 1973, and Ed Post's Real Programmers Don't Use Pascal ten years later, but for a long time after that it was much more exclusively suit -oriented and boring. Following a change of editorship in 1994, Datamation briefly tried for more the technical content and irreverent humor that marked its early days, but this did not last.
+        /day`t@maysh@n/ , n. A magazine that many hackers assume all suits read. Used to question an unbelieved quote, as in Did you read that in Datamation?. It used to publish something hackishly funny every once in a while, like the original paper on COME FROM in 1973, and Ed Post's Real Programmers Don't Use Pascal ten years later, but for a long time after that it was much more exclusively suit-oriented and boring. Following a change of editorship in 1994, Datamation briefly tried for more the technical content and irreverent humor that marked its early days, but this did not last.
         </p>
         <H4>Dave the Resurrector</H4>
         <p>
@@ -1693,7 +1693,7 @@ This file last generated Monday, 24 December 2018 12:25PM UTC
         </p>
         <H4>Real Programmer</H4>
         <p>
-        n. [indirectly, from the book Real Men Don't Eat Quiche ] A particular sub-variety of hacker: one possessed of a flippant attitude toward complexity that is arrogant even when justified by experience. The archetypal Real Programmer likes to program on the bare metal and is very good at same, remembers the binary opcodes for every machine he has ever programmed, thinks that HLLs are sissy, and uses a debugger to edit his code because full-screen editors are for wimps. Real Programmers aren't satisfied with code that hasn't been tuned into a state of tense ness just short of rupture. Real Programmers never use comments or write documentation: If it was hard to write , says the Real Programmer, it should be hard to understand. Real Programmers can make machines do things that were never in their spec sheets; in fact, they are seldom really happy unless doing so. A Real Programmer's code can awe with its fiendish brilliance, even as its crockishness appalls. Real Programmers live on junk food and coffee, hang line-printer art on their walls, and terrify the crap out of other programmers because someday, somebody else might have to try to understand their code in order to change it. Their successors generally consider it a Good Thing that there aren't many Real Programmers around any more. For a famous (and somewhat more positive) portrait of a Real Programmer, see The Story of Mel' in Appendix A. The term itself was popularized by a letter to the editor in the July 1983 Datamation titled Real Programmers Don't Use Pascal by Ed Post, still circulating on Usenet and Internet in on-line form. Typing Real Programmers Don't Use Pascal into a web search engine should turn up a copy.
+        n. [indirectly, from the book Real Men Don't Eat Quiche] A particular sub-variety of hacker, having an over-inflated opinion of their own skills. Also see the Dunning-Kruger effect from psychology. Real Programmer etiquette requires constantly demanding that "Real Programmers do X", where X is something like coding directly in binary or being able to understand ridiculous regexes. A modern incarnation of the Real Programmer phenomena is the so-called "brogrammer", who tries to mask a deficit in skills with absurd levels of machismo and obsessions with personal status or irrelevant qualifications. An article called "Real Programmers Don't Use Pascal" by Ed Post appeared in a 1982 edition of Datamation. It parodied the style of the "Real Men" book with an outrageous and highly misogynistic description of Fortran programmers forgetting their wives names and refusing to wear high heels.
         </p>
         <H4>Real Soon Now</H4>
         <p>1. Supposed to be available (or fixed, or cheap, or whatever) real soon now according to somebody, but the speaker is quite skeptical. </p>

docs/jargon.org

@@ -19,7 +19,7 @@ Free Documentation License".
 
 * Generated
 
-This file last generated Monday, 24 December 2018 12:25PM UTC
+This file last generated Monday, 24 December 2018 12:57PM UTC
 
 * Glossary
 ** (
@@ -440,7 +440,7 @@ n. [alt.(sysadmin|tech-support).recovery; abbrev. for Dick Size War ] A contest
 4. Of a person, someone whose directions are incomprehensible and vague, but who nevertheless has the expectation that you will solve the problem using the specific method he/she has in mind. Warren Teitelman originally wrote DWIM to fix his typos and spelling errors, so it was somewhat idiosyncratic to his style, and would often make hash of anyone else's typos if they were stylistically different. Some victims of DWIM thus claimed that the acronym stood for Damn Warren s Infernal Machine!'. In one notorious incident, Warren added a DWIM feature to the command interpreter used at Xerox PARC. One day another hacker there typed delete *$ to free up some disk space. (The editor there named backup files by appending $ to the original file name, so he was trying to delete any backup files left over from old editing sessions.) It happened that there weren't any editor backup files, so DWIM helpfully reported *$ not found, assuming you meant 'delete *'. It then started to delete all the files on the disk! The hacker managed to stop it with a Vulcan nerve pinch after only a half dozen or so files were lost. The disgruntled victim later said he had been sorely tempted to go to Warren's office, tie Warren down in his chair in front of his workstation, and then type delete *$ twice. DWIM is often suggested in jest as a desired feature for a complex program; it is also occasionally described as the single instruction the ideal computer would have. Back when proofs of program correctness were in vogue, there were also jokes about DWIMC (Do What I Mean, Correctly). A related term, more often seen as a verb, is DTRT (Do The Right Thing); see Right Thing.
 
 *** Datamation
-/day`t@maysh@n/ , n. A magazine that many hackers assume all suits read. Used to question an unbelieved quote, as in Did you read that in Datamation?. It used to publish something hackishly funny every once in a while, like the original paper on COME FROM in 1973, and Ed Post's Real Programmers Don't Use Pascal ten years later, but for a long time after that it was much more exclusively suit -oriented and boring. Following a change of editorship in 1994, Datamation briefly tried for more the technical content and irreverent humor that marked its early days, but this did not last.
+/day`t@maysh@n/ , n. A magazine that many hackers assume all suits read. Used to question an unbelieved quote, as in Did you read that in Datamation?. It used to publish something hackishly funny every once in a while, like the original paper on COME FROM in 1973, and Ed Post's Real Programmers Don't Use Pascal ten years later, but for a long time after that it was much more exclusively suit-oriented and boring. Following a change of editorship in 1994, Datamation briefly tried for more the technical content and irreverent humor that marked its early days, but this did not last.
 
 *** Dave the Resurrector
 n. [Usenet; also abbreviated DtR] A cancelbot that cancels cancels. Dave the Resurrector originated when some spam -spewers decided to try to impede spam-fighting by wholesale cancellation of anti-spam coordination messages in the news.admin.net-abuse.usenet newsgroup.
@@ -1383,7 +1383,7 @@ The malign force which lurks behind the random number generator in Angband (and
 Omnivorous. Hackers often have a reading range that astonishes liberal arts people but tend not to talk about it as much. Many hackers spend as much of their spare time reading as the average prole burns up watching TV/movies, and often have an extensive epub/pdf collection on a storage device or server somewhere.
 
 *** Real Programmer
-n. [indirectly, from the book Real Men Don't Eat Quiche ] A particular sub-variety of hacker: one possessed of a flippant attitude toward complexity that is arrogant even when justified by experience. The archetypal Real Programmer likes to program on the bare metal and is very good at same, remembers the binary opcodes for every machine he has ever programmed, thinks that HLLs are sissy, and uses a debugger to edit his code because full-screen editors are for wimps. Real Programmers aren't satisfied with code that hasn't been tuned into a state of tense ness just short of rupture. Real Programmers never use comments or write documentation: If it was hard to write , says the Real Programmer, it should be hard to understand. Real Programmers can make machines do things that were never in their spec sheets; in fact, they are seldom really happy unless doing so. A Real Programmer's code can awe with its fiendish brilliance, even as its crockishness appalls. Real Programmers live on junk food and coffee, hang line-printer art on their walls, and terrify the crap out of other programmers because someday, somebody else might have to try to understand their code in order to change it. Their successors generally consider it a Good Thing that there aren't many Real Programmers around any more. For a famous (and somewhat more positive) portrait of a Real Programmer, see The Story of Mel' in Appendix A. The term itself was popularized by a letter to the editor in the July 1983 Datamation titled Real Programmers Don't Use Pascal by Ed Post, still circulating on Usenet and Internet in on-line form. Typing Real Programmers Don't Use Pascal into a web search engine should turn up a copy.
+n. [indirectly, from the book Real Men Don't Eat Quiche] A particular sub-variety of hacker, having an over-inflated opinion of their own skills. Also see the Dunning-Kruger effect from psychology. Real Programmer etiquette requires constantly demanding that "Real Programmers do X", where X is something like coding directly in binary or being able to understand ridiculous regexes. A modern incarnation of the Real Programmer phenomena is the so-called "brogrammer", who tries to mask a deficit in skills with absurd levels of machismo and obsessions with personal status or irrelevant qualifications. An article called "Real Programmers Don't Use Pascal" by Ed Post appeared in a 1982 edition of Datamation. It parodied the style of the "Real Men" book with an outrageous and highly misogynistic description of Fortran programmers forgetting their wives names and refusing to wear high heels.
 
 *** Real Soon Now
 1. Supposed to be available (or fixed, or cheap, or whatever) real soon now according to somebody, but the speaker is quite skeptical. 

entries/Datamation.txt

@@ -5,7 +5,7 @@ Used to question an unbelieved quote, as in Did you read that in
 Datamation?. It used to publish something hackishly funny every once in a
 while, like the original paper on COME FROM in 1973, and Ed Post's Real
 Programmers Don't Use Pascal ten years later, but for a long time after that
-it was much more exclusively suit -oriented and boring. Following a change
+it was much more exclusively suit-oriented and boring. Following a change
 of editorship in 1994, Datamation briefly tried for more the technical
 content and irreverent humor that marked its early days, but this did not
 last.