Commits

shl...@iglu.org.il@cec68495-dca5-4e2b-845c-11fdaaa4f967  committed 256bba9

Convert more single/double quotes to Unicode

  • Participants
  • Parent commits 332d121

Comments (0)

Files changed (4)

 
 $(T2_DEST)/philosophy/psychology/hypomanias/index.html: $(DOCBOOK5_RENDERED_DIR)/dealing-with-hypomanias.xhtml
 
-$(T2_DEST)/philosophy/perl-newcomers-v1/index.html: $(DOCBOOK5_RENDERED_DIR)/usability-of-perl-world-for-newcomers.xhtml
+$(T2_DEST)/philosophy/perl-newcomers/v1/index.html: $(DOCBOOK5_RENDERED_DIR)/usability-of-perl-world-for-newcomers.xhtml
 
 $(T2_DEST)/philosophy/case-for-file-swapping/revision-3/index.html: $(DOCBOOK4_RENDERED_DIR)/case-for-file-swapping-rev3.html
 

File lib/docbook/5/xml/usability-of-perl-world-for-newcomers.xml

-<!-- Converted by db4-upgrade version 1.0 -->
-
+<?xml version='1.0' encoding='utf-8'?>
 <article xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="index"
     xmlns:xlink="http://www.w3.org/1999/xlink">
     
     <info>
-        <title>"Usability" of the Perl Online World for Newcomers</title>
+        <title>Usability of the Perl Online World for Newcomers</title>
 
         <authorgroup>
             <author>
                 <affiliation>
                     <address>
                         <email>shlomif@shlomifish.org</email>
-                        <uri type="homepage" xlink:href="http://www.shlomifish.org/">Shlomi Fish's Homepage</uri>
+                        <uri type="homepage" xlink:href="http://www.shlomifish.org/">Shlomi Fishs Homepage</uri>
                     </address>
                 </affiliation>
             </author>
                 <authorinitials>shlomif</authorinitials>
                 <revremark>
                     Removed a paragraph that is less than accurate, added
-                    a link to ESR's CatB, and refactored a few things.
+                    a link to ESRs CatB, and refactored a few things.
                 </revremark>
             </revision>
             <revision>
                 <authorinitials>shlomif</authorinitials>
                 <revremark>
                     Made the criticism against the inavailability of the 
-                    O'Reilly core Perl documentation less blunt, and added
+                    OReilly core Perl documentation less blunt, and added
                     a suggestion for the www.perl.com site. Fixed some
                     typos.
                 </revremark>
         <info><title>Me as a Perl Newbie</title></info>
 
         <para>
-            "Shlomi, it takes 10 years to learn UNIX. I want you to learn it 
-            in a month". My future supervisor in a web publishing house I 
-            switched jobs to, told me that and It'll be a cold day in hell 
+            “Shlomi, it takes 10 years to learn UNIX. I want you to learn it 
+            in a month”. My future supervisor in a web publishing house I 
+            switched jobs to, told me that and It’ll be a cold day in hell 
             before I forget this quote. He also showed me Perl, telling me I
             can write a TCP/IP client in 5 lines and a TCP server in 10, which
             sounded very impressive and intriguing. So I set out to learn 
         <para>
             I only had a Windows 3.11 at home, and so started learning Perl
             from all the POD documents cramped into one Acrobat Reader file.
-            "On dry", as they say in Israel, without actually running it. I 
+            On dry, as they say in Israel, without actually running it. I 
             understood some of it as it reminded me of C and BASIC which I knew 
             quite well. But still there were all these references to sed, awk,
             UNIX shells, and other things I did not know. Generally, they 
             I started working there, and was able to get by with my little 
             knowledge of Perl and UNIX which accumulated quite quickly. I 
             remember asking my supervisor what regular expressions where all 
-            about and he told me: "they are a mechanism to find patterns in 
-            text". That was the enlightenment that made me able to use them
+            about and he told me: “they are a mechanism to find patterns in 
+            text”. That was the enlightenment that made me able to use them
             on a regular basis.
         </para>
         <para>
             I fell in love with both UNIX and Perl. I was not much of a UNIX 
             guru and wrote what I now write in shell in Perl, and simply kept
-            asking my supervisor (who was then a true UNIX guru even in today's
+            asking my supervisor (who was then a true UNIX guru even in todays
             standards), questions about how to do things. But I got by.
         </para>
         <para>
             else.
         </para>
         <para>
-            That's my story. Now let's move to the story of Mel Jones (short
+            Thats my story. Now lets move to the story of Mel Jones (short
             for Melissa but might as well be Melvin), a Perl newbie who wishes
             to get hold of Perl. When thinking about the usability of computer
             systems, it is helpful to think about a few imaginary figures,
             which one is almost certain there are many similar that exist in
-            real-life. Mel is one of them, but as you'll see later she won't be
+            real-life. Mel is one of them, but as youll see later she wont be
             the only one.
         </para>
         <para>
             and brought Perl so far. I did not come to bury Perl or the Perl 
             world in this article. I simply came to pass some constructive
             criticism and suggestions to further aid its public acceptance. 
-            Perl is the nicest language I've seen so far, and I would highly
+            Perl is the nicest language Ive seen so far, and I would highly
             recommend anyone to learn it.
         </para>
         <para>
             Bio-informatics engineer, hardware designer, QA engineer or
             whatever. She wishes to do something that seems awfully hard with
             what she already knows, asks around and receive a simple answer
-            "Perl would be perfect for it. And it is spelled P.E.R.L" 
+            Perl would be perfect for it. And it is spelled P.E.R.L 
         </para>
         <para>
             So Mel goes on looking for this strange and perfect language 
-            called "perl" (without the 'a'). Where does she go first?
+            called perl (without the ‘a’). Where does she go first?
             <link xlink:href="http://www.google.com/">Google</link>? Most probably. 
             What does she discover? www.perl.com is the first hit. An 
-            overcrowded site with a lot of O'Reillyisms with several articles
+            overcrowded site with a lot of OReillyisms with several articles
             that are way over her head. Perl Mongers is the second hit. She
             reads on - groups of Perl users - goodie. Now if she knows how to 
             use E-mail (she may or may not have such a good net-wisdom), she 
             may have hit the jackpot, because most Perl monger groups are very 
             friendly to newbies. Then she discovers CPAN (Mel 
-            says: "What is it and why do I need it?"). ActiveState (a 
+            says: What is it and why do I need it?). ActiveState (a 
             commercial site which may or may not scare her) and Use Perl, which 
             is a nice site for Perl News, but she is naturally interested in 
-            the Perl's status quo.
+            the Perls status quo.
         </para>
         <para>
-            She refines her query: "learn perl", "begin perl", "perl newbie"
-            or "perl beginners". The concentrated site for perl beginners is
+            She refines her query: “learn perl”, “begin perl”, “perl newbie”
+            or “perl beginners”. The concentrated site for perl beginners is
             <link xlink:href="http://learn.perl.org/">learn.perl.org</link>. It 
             contains some reviews of books (which Mel may not have time to
             read), a free online book (again, same issue) and no links to 
-            tutorials whatsoever. IMHO, the site's visual side is also very 
+            tutorials whatsoever. IMHO, the sites visual side is also very 
             lacking and she may come to believe it is a sub-standard site as
             a result.
         </para>
             OK. Maybe Mel was given the Llama book on the first day of her job
             as a gesture from her employer. Maybe this employer has these books
             online on his intranet for everybody to see. (there are also
-            illegal or unfirewalled mirrors of these books, but let's suppose
+            illegal or unfirewalled mirrors of these books, but lets suppose
             Mel is a lawful citizen who respects copyrights.) The question
-            still stands: why do you need a book to learn Perl? Why can't you
+            still stands: why do you need a book to learn Perl? Why cant you
             learn it from the Internet alone? Why kill trees, when you can
             simply transfer electrons from place to place to study it?
         </para>
             include: Slash (the back-end of Slashdot), SourceForge/GForge,
             Bugzilla, Zope, PySol, The Mandrake Linux System Tools and
             Installer, <link xlink:href="http://www.frozen-bubble.org/">Frozen Bubble</link> (;-)), SpamAssassin, and many other things
-            I don't recall or forgot about momentarily. Furthermore, a lot of
+            I dont recall or forgot about momentarily. Furthermore, a lot of
             code of such languages is used internally and not exposed to the
             world, and plays a large role behind the scenes.
         </para>
         <!-- To do: hyperlink -->
         <para>
-            They are still often referred to as "scripting languages", but this
+            They are still often referred to as scripting languages, but this
             term can no longer accurately describe them. While a Java-obsessed
             friend of mine asked me to give him an example for a proprietary 
             application of a large codebase that is written in Perl, and I
             ready, and not a toy language for hackers anymore.
         </para>
         <para>
-            Now, let's go back to Mel. She needs to learn Perl. But she might
+            Now, lets go back to Mel. She needs to learn Perl. But she might
             as well have been told to learn PHP, Python, Visual Basic or
             whatever. My problem is I think she would have a much harder time
-            with Perl than with the others. No, it's not because Perl is a
-            harder <emphasis>language</emphasis> than the others. I don't think
-            it is. It's because the resources available online are inadequate
+            with Perl than with the others. No, it’s not because Perl is a
+            harder <emphasis>language</emphasis> than the others. I don’t think
+            it is. It’s because the resources available online are inadequate
             or may scare her. And as <link xlink:href="http://www.perl.com/pub/a/2001/05/29/tides.html">Casey
                 West noted in a previous attempt at correcting the
                 situation</link>, the Perl community is relatively hostile to
                 no one is born with an innate knowledge of Perl, UNIX or 
                 whatever. I often work in the Technion farms and whenever 
                 I overhear that someone has a problem my ears become pointed, 
-                and I cry "do you need help?" And then show him how to do 
+                and I cry do you need help? And then show him how to do 
                 something that for me may be perfectly obvious. Seriously. I 
                 simply enjoy doing that. 
             </para>
                 Lately, out of frustration with the learn.perl.org site, I started
                 working on <link xlink:href="http://perl-begin.berlios.de/">my 
                     own version of a Perl beginners site</link>. Now here is where
-                things went a bit wrong in my opinion. However, I don't want
-                to defame anyone so I'll summarize. Both the 
-                <link xlink:href="http://use.perl.org/">use.perl.org</link>'s editor 
+                things went a bit wrong in my opinion. However, I don’t want
+                to defame anyone so I’ll summarize. Both the 
+                <link xlink:href="http://use.perl.org/">use.perl.org</link>’s editor 
                 and a very prominent Perl figure that stumbled upon the site,
                 believed that I should merge my work with learn.perl.org. At
                 first, I thought it was a good idea, but then discover I 
                 their mailing lists was closed for subcription.
             </para>
             <para>
-                Regardless, what's wrong with two Perl beginners site on the
+                Regardless, whats wrong with two Perl beginners site on the
                 Internet? If I feel that learn.perl.org is inadequate, why
                 should my effort be frowned upon? If we take PHP or Visual
                 Basic for example, than everyone and his mother have a PHP
                 portal where users can post questions (sometimes without
                 subscribring), receive answers, read tutorials and see code
                 snippets. Same for Visual Basic, despite the fact that it is
-                proprietary. I want the same for Perl! I don't want a couple of
+                proprietary. I want the same for Perl! I dont want a couple of
                 concentrated perl.org and perl.com and oreillynet.com sites. I
                 want a real network of independant sites!
             </para>
             <para>
-                It also demonstrates the Perl community's elitism. I don't know
+                It also demonstrates the Perl communitys elitism. I dont know
                 how it came into being. For example, when I log into EF-Net,
                 the channel #perl displays a long title that reads something
-                like: "Not a Helpdesk! No CGI/WWW/Net::IRC/FAQ.". OK, there's
+                like: Not a Helpdesk! No CGI/WWW/Net::IRC/FAQ.. OK, theres
                 also #perlhelp where such questions are accepted. But here are
                 two facts from a user interface designer point of view:
             </para>
                         <para>
                         People are not going to read the title. In a user 
                         interface, you are lucky if people read anything at 
-                        all. (including: "Delete and Expunge 'My most 
-                        important work'?")
+                        all. (including: “Delete and Expunge ‘My most 
+                        important work’?”)
                     </para>
                     </listitem>
                     <listitem>
                         <para>
                         Newbies by nature will try #perl if they log into a 
-                        random IRC server. And they don't want to get flamed
+                        random IRC server. And they dont want to get flamed
                         for being off-topic there.
                     </para>
                     </listitem>
             </para>
             <para>
                 In another IRC network, I (not a newbie by far) was kicked
-                because I pasted a URL and said the word CGI. (there's a nasty
+                because I pasted a URL and said the word CGI. (theres a nasty
                 pattern bot there). Some other time, I was kicked out of
                 #perlhelp, because I said the built-in function hex() converts
                 numbers from hexadecimal to decimal, while a moderator believed
             <info><title>Lack of Adequate Online Resources</title></info>
             
             <para>
-                Let's face it: at the moment, there aren't too many good Perl
+                Lets face it: at the moment, there arent too many good Perl
                 tutorials online. Many people who ask trivial questions are
-                being conveyed something like "Read the Llama Book, the Camel 
+                being conveyed something like Read the Llama Book, the Camel 
                 Book, the Black Panther book, the Perl Cookbook, and then 
-                you'll know how to convert a file to lowercase." Maybe I'm 
+                youll know how to convert a file to lowercase. Maybe Im 
                 exagerrating a little, but it seems people are so content with
-                the books that they don't seem to think people who don't want 
-                them, cannot afford to buy them, or don't have time for them,
+                the books that they don’t seem to think people who don’t want 
+                them, cannot afford to buy them, or don’t have time for them,
                 are worthy of learning Perl.
             </para>
             <para>
-                I don't have anything against people trying to make money off 
+                I dont have anything against people trying to make money off 
                 Perl by selling books. But these people are the same people 
                 who are the Perl project leaders, and so are responsible to 
                 make sure Perl is well-documented. If people get frustrated
                 learning Perl, and become unhappy with it, they will criticize
-                "Perl". Not the Perl documentation. Not the Perl community.
-                Not even the Perl leaders. <emphasis>"Perl"</emphasis>.
+                “Perl”. Not the Perl documentation. Not the Perl community.
+                Not even the Perl leaders. <emphasis>“Perl”</emphasis>.
                 If Larry Wall et al. care enough about Perl, they should make
-                sure it has good online documentation. They don't have to do 
+                sure it has good online documentation. They dont have to do 
                 it themselves, as a simple call for action by a very prominent
-                Perl figure will do. (in accordance to Eric Raymond's 
-                <link xlink:href="http://www.catb.org/~esr/writings/cathedral-bazaar/cathedral-bazaar/">"The Cathedral and the Bazaar"</link>)
+                Perl figure will do. (in accordance to Eric Raymond’s 
+                <link xlink:href="http://www.catb.org/~esr/writings/cathedral-bazaar/cathedral-bazaar/">“The Cathedral and the Bazaar”</link>)
             </para>
             <para>
                 If we take a look at Python or PHP for instance, then they 
                 Perl with the same ease.
             </para>
             <para>
-                I am grateful for Simon Cozens for making his "Beginning Perl"
+                I am grateful for Simon Cozens for making his 
+                <emphasis>Beginning Perl</emphasis>
                 book online for free. I did not take a thorough look at the 
-                book, but it is more encompassing than anything I've seen. But 
+                book, but it is more encompassing than anything Ive seen. But 
                 even one book is not enough. People still want step by step 
                 tutorials and things they can cut and paste code out of and 
                 tinker it to do something. 
                 legitimate? When they are not absolutely needed. I learned
                 the Perl DBI by reading the man page and the online site and
                 asking a few questions. Some people do not like man pages too
-                much and would rather buy a book that covers Perl DBI. That's
+                much and would rather buy a book that covers Perl DBI. Thats
                 OK, and there may be a few fine points of working with DBI that
-                I missed with what I call my "bottom-up learning".
+                I missed with what I call my bottom-up learning.
             </para>
             <para>
                 Such books need not be available online if their authors so
-                much don't desire. However, Perl is very hard to learn from
+                much dont desire. However, Perl is very hard to learn from
                 public electronic resources alone. I believe there may even
                 be a clash of interests because the core Perl people also
                 write them and so may not have enough motivation to improve
                 That aside, I also believe that making it available online will
                 not dent their sales much. I still would like to buy the Camel
                 Book (which I borrowed from the local Perl Mongers library),
-                and loved regardless if it's online so I can read it at bed
+                and loved regardless if its online so I can read it at bed
                 time and stuff. And I generally have no problems using a
                 computer book or tutorial.
             </para>
                 very high volume, and usually whenever one considers
                 replying to a question, it receives three replies by the time
                 he finished composing it. I was also subscribed and it was
-                too high volume to be effective for me as a "guru". I believe
+                too high volume to be effective for me as a guru. I believe
                 newbies will not be able to handle such volumes either. Unless
                 they can configure their mail readers to filter only their own
-                threads, which I'm not sure they can. Perl can do that, but
+                threads, which Im not sure they can. Perl can do that, but
                 they need to know it first.
             </para>
             <para>
                 Like I said earlier, I think distributism is the key to our
                 success here. Just like there are many scientific journals with
-                very similar names and themes, (sometimes, "Physics A",
-                "Physics B", "Physics C" etc), so there should be several
+                very similar names and themes, (sometimes, “Physics A”,
+                “Physics B”, “Physics C” etc), so there should be several
                 international Perl beginners sites, each with his own mailing
                 list for beginners. Gurus will subscribe to one or more sites
-                and answer questions there, and newbies won't have to
+                and answer questions there, and newbies wont have to
                 excessively use their delete button. Gradually, each such
                 community will have a different atmosphere, and we will get a
                 more diversified Perl world. (we all agree that diversity is
-                good, right? If you don't you should program in Python)
+                good, right? If you dont you should program in Python)
             </para>
         </section>
         </section>
             <info><title>Substandard Standard Documentation</title></info>
             
             <para>
-                Let's face it, the man pages (or perl*.pod), which are the 
+                Lets face it, the man pages (or perl*.pod), which are the 
                 definitive resource on the exact behaviour of Perl are very 
                 bad. Maybe they were OK for expert Perl 4 or Tcl hackers, or 
                 those that knew UNIX shells, sed and awk well. But nowadays 
                 DOS or Windows command line, much less UNIX wizardry. 
             </para>
             <para>
-                Perl is not and cannot be a "point-and-click-no-think"
-                language. I'm not going to fall into the trap of trying to make
+                Perl is not and cannot be a “point-and-click-no-think”
+                language. I’m not going to fall into the trap of trying to make
                 it so. Even the lamest GUI kiddie eventually learns to
                 invoke a text editor and write some glue code for whatever he
                 needs to get a web-site or whatever working. Perl is much too
                 variables, functions, objects, modules and other abstractions
                 is not something that for people above a certain age is easy 
                 to overcome. Visual Basic for Applications is one of the things
-                I like most in Excel, but most people don't know it, and most
-                books don't teach it. Why? Because it involves actual coding 
-                and people don't like that. Ironically, it's very useful, too.
+                I like most in Excel, but most people don’t know it, and most
+                books don’t teach it. Why? Because it involves actual coding 
+                and people don’t like that. Ironically, it’s very useful, too.
             </para>
             <para>
                 Now, a documentation should guide a newbie step by step
                 object, etc. All these things may have different semantics
                 in Perl than in most other languages. And all these things
                 need to be explained clearly and reasonably, without depending
-                on an analogy to tools that are way over Mel's head at her
+                on an analogy to tools that are way over Mels head at her
                 current position.
             </para>
             <para>
-                I don't want this knowledge to be hidden from the world in some
-                proprietary O'Reilly books. I did my best to remedy it, and
+                I don’t want this knowledge to be hidden from the world in some
+                proprietary O’Reilly books. I did my best to remedy it, and
                 Simon Cozens did even more. I think the reason people think
                 Perl is such a poor language to learn or even for complete
                 beginners, is not because of the syntax and semantics
                 themselves, but because of its poor documentation. That put
                 aside, I think publishers making their books available online,
                 will only help them sell more books (assuming these books are
-                good, of course).  Otherwise it's similar to buying an
+                good, of course).  Otherwise its similar to buying an
                 apartment without seeing it first.
             </para>
         </section>
             
             <para>
                 Hubris is one of the three great virtues of the programmer
-                according to Larry Wall. But he <link xlink:href="http://www.oreilly.com/catalog/opensources/book/larry.html">also noted in "Open Sources"</link>
-                that humility was a good quality as well. Don't get me wrong
+                according to Larry Wall. But he <link xlink:href="http://www.oreilly.com/catalog/opensources/book/larry.html">also noted in 
+                    “Open Sources”</link>
+                that humility was a good quality as well. Don’t get me wrong
                 some projects have much more hubris than Perl: Python and Linux
-                come to mind. I'm not saying all Pythoneers or Linuxers are
-                hubris-ful. But a small minority is too loud, and there's
+                come to mind. I’m not saying all Pythoneers or Linuxers are
+                hubris-ful. But a small minority is too loud, and there’s
                 a similar case in Perl to a lesser extent.
             </para>
             <para>
-                What do I mean by hubris? "Perl is the greatest language since
+                What do I mean by hubris? Perl is the greatest language since
                 sliced bread. It has unparalleled text processing and data
                 strucutres support. It is object-oriented, supports functional
-                programming and any other programming paradigm very well. It's
+                programming and any other programming paradigm very well. Its
                 perfect for almost any task, from powering web-sites to writing
-                GUI to writing games. It's practically LISP with in-fix 
-                notation, and runs on almost any platform imaginable..." 
+                GUI to writing games. It’s practically LISP with in-fix 
+                notation, and runs on almost any platform imaginable...” 
             </para>
             <para>
-                You get the drift? Why I think it's bad? Because most
-                people don't like communities with this sales pitch. When 
+                You get the drift? Why I think it’s bad? Because most
+                people don’t like communities with this sales pitch. When 
                 recommending Perl to someone, you should discuss one advantage
                 at a time, not overload him with a lot of information. When
-                people see a lot of information they think there's something
+                people see a lot of information they think theres something
                 fishy about this.
             </para>
             <para>
-                Let's take a look at a language with just the right amount of
+                Lets take a look at a language with just the right amount of
                 hubris: Visual Basic. Right, a language that Microsoft has 
                 released several versions of, each adding major things, but 
                 is still inferior to perl 5.000. A language whose code can 
                 only be deployed on Windows. A language that is many times 
                 useless without a whole slew of OCX or OLE components that
                 are freely available at best. Still, Microsoft and the other
-                VB community do not claim it's the greatest language on earth.
-                "I take your word that Perl/Python/Ruby/LISP/whatever is much
-                superior. VB is stupid, but cute and it gets the job done."
-                That's the attitude we should have: Perl gets the job done.
+                VB community do not claim it’s the greatest language on earth.
+                “I take your word that Perl/Python/Ruby/LISP/whatever is much
+                superior. VB is stupid, but cute and it gets the job done.”
+                That’s the attitude we should have: Perl gets the job done.
                 Granted, many different jobs. But as far as Mel is concerned
-                it only gets her job done and not the entire world's ones.
+                it only gets her job done and not the entire worlds ones.
             </para>
         </section>
     </section>
     <section xml:id="the_threat">
-        <info><title>What's the threat?</title></info>
+        <info><title>Whats the threat?</title></info>
         
         <para>
             You can often hear opinions or wonderings in the vein of: will PHP
             kill Perl? Will Python kill Perl? Will Java kill Perl? Will FooLang
-            kill Perl? I don't think anyone of them can hope to. I don't think 
+            kill Perl? I dont think anyone of them can hope to. I dont think 
             Perl will completely eliminate any of them either, but I think 
-            Perl's status is secured.
+            Perls status is secured.
         </para>
         <para>
             Perl is too syntactically and semantically rich a language to be 
             interesting Perl personalities. The Perl community is alive and
             kicking and proud of being such. While some people abandon it for
             Python, Ruby or whatever, most of them still think Perl is a nice
-            language, and don't abandon it or completely or completely 
-            antagonize it. The beauty of the Perl culture is that it's about 
+            language, and don’t abandon it or completely or completely 
+            antagonize it. The beauty of the Perl culture is that it’s about 
             using the right tool for the job whether in Perl or not.
         </para>
         <para>
             We all know 80% of the users use 20% of the features of a given
             program. However, as <link xlink:href="http://www.joelonsoftware.com/articles/fog0000000020.html">Joel
                 Spolsky identified</link> they often use a differnet set of
-            features. Perl's feature-set is huge, but you can survive with
+            features. Perls feature-set is huge, but you can survive with
             knowing maybe 10% or even less of it. Moreover, you can gradually
             learn more and more features and keep learning new ones. Perhaps
             only the three authors of Programming Perl know the entire feature
             set, and I believe even they are actively unaware of some obscure
-            details of it. However, one always feels he's getting closer to
+            details of it. However, one always feels hes getting closer to
             100%.
         </para>
         <para>
             her writing it in Perl, because otherwise, it will take her more 
             time to get to learn Perl. As much as I care about the quality of
             Perl programmers (which is actually quite good) I also think we 
-            should evangelize it to many people who'll find it useful. 
+            should evangelize it to many people wholl find it useful. 
         </para>
         <para>
-            Moreover, I don't like Mel becoming one of those characters who say:
-            "Perl? This horrible language? I'm using PHP/Python/Ruby/Java. It's 
-            much better than Perl." I don't think there's a way to exactly 
-            measure which language is "better". Some languages are better in
+            Moreover, I don’t like Mel becoming one of those characters who say:
+            “Perl? This horrible language? I’m using PHP/Python/Ruby/Java. It’s 
+            much better than Perl.” I don’t think there’s a way to exactly 
+            measure which language is “better”. Some languages are better in
             some regards and for some purposes than others. But Perl is much
-            more than a language. It's a culture and a philosophy.
+            more than a language. Its a culture and a philosophy.
         </para>
         <para>
             Perl has a lot of potential for Mel. Alternatively, it has such for
             Joanna Simpson, a CEO of a Fortune 500 firm who is trying to
-            ship her automobile-company's new car model. I think we should
+            ship her automobile-companys new car model. I think we should
             even try to teach Joanna Perl, because not only will she learn how
             great a language it is, but it may actually be useful for her in
             her day for day work. Otherwise, she would tell Robert, her
             other software cannot do for him.
         </para>
         <para>
-            Perl should be everywhere. Let's not ruin the day for Mel, Joanna 
+            Perl should be everywhere. Lets not ruin the day for Mel, Joanna 
             or Robert by a bad attitude. Remember that at a time, we were not
             much more educated than them. Not even old time UNIX gurus like
             Ken Thompson or Larry Wall can claim that, because UNIX and Perl 
         </para>
         <para>
             Furthermore helping newbies is <emphasis>fun</emphasis> and makes
-            you feel good. You don't have a moral obligation to do so, but I
-            believe you'll find helping someone even with a trivial question
+            you feel good. You don’t have a moral obligation to do so, but I
+            believe you’ll find helping someone even with a trivial question
             even more enjoyable then getting help for something that bothered
-            you. That's how the open-source world works.
+            you. Thats how the open-source world works.
         </para>
         <para>
             You may eventually find yourself in a similar situation in
             something else entirely, and may need help by people who are more
             expert than you are.  During my Electrical Engineering studies I
             studied things that were much less straightforward to me than
-            either Perl or UNIX (which I don't consider easy either), and
-            sometimes the help of the lecturers, the T.A.'s or fellow students
+            either Perl or UNIX (which I don’t consider easy either), and
+            sometimes the help of the lecturers, the T.A.’s or fellow students
             proved crucial to understanding them. Moreover, explaining
             something to someone who grasps it much less than you, is the
             best way of learning (even better than actually experiencing with
-            something yourself).  That's because when teaching someone, you
+            something yourself).  Thats because when teaching someone, you
             have to think how to convey it using more basic knowledge in a
             strucutured way, and so understand it much better.
         </para>
         
         <para>
             Until now it has been a long rant with some sprinkled advice in
-            between. Now let's get to the real action. Here is what I think
+            between. Now lets get to the real action. Here is what I think
             should be done, in no particular order.
         </para>
         <section xml:id="what_should_establish_something">
             <para>
                 Establish your own Perl beginners site/portal/mailing 
                 list/web forum/etc. learn.perl.org is not enough and
-                neither is what I'm going to do. We need more and as
+                neither is what Im going to do. We need more and as
                 many as possible.
             </para>
             <para>
-                Note that if you feel that there isn't enough traffic
-                or that you should merge with some other site - it's
+                Note that if you feel that there isn’t enough traffic
+                or that you should merge with some other site - it’s
                 OK and you can do so. As always reason and experience
-                are your best guidelines as there isn't a precise rulebook
+                are your best guidelines as there isnt a precise rulebook
                 for surviving in real life.
             </para>
         </section>
             <para>
                 Remember that the biggest Perl guru is 
                 <emphasis>you</emphasis>. Not Larry Wall or Tom
-                Christiansen or Damian Conway or whoever. That's 
+                Christiansen or Damian Conway or whoever. Thats 
                 because none of them can dictate to you how to work
                 with Perl, solve problems with it or with something 
                 else, etc. As much as I appreciate their efforts at
-                making Perl better and more usable, I don't think 
+                making Perl better and more usable, I dont think 
                 they have or should have a monopoly on where Perl is 
                 going to. The world is your oyster.
             </para>
             <info><title>Treat Beginners Nicely and Help Them</title></info>
             
             <para>
-                Be kind to newbies, answer them accurately, don't 
+                Be kind to newbies, answer them accurately, dont 
                 confuse them and try to use Perl that is as simple
-                and non-idiomatic as possible (e.g: for the file's 
-                lowercasing example, don't use Tie::File, and prefer
+                and non-idiomatic as possible (e.g: for the file’s 
+                lowercasing example, don’t use Tie::File, and prefer
                 lc() over tr///).
             </para>
             <para>
-                If you don't have the time to write the entire code
-                for the beginner - politely tell him you can't
+                If you don’t have the time to write the entire code
+                for the beginner - politely tell him you can’t
                 help him at this point or whenever. Else, try to 
                 actually write some code which would be as clear
-                and commented as possible. Don't expect beginners
+                and commented as possible. Dont expect beginners
                 to like Perl Golf snippets. They may mistake them
                 for line noise. ;-)
             </para>
                     <para>
                         Think about the User-Interface Design of the System. 
                         What will the user assume? What would be the first
-                        thing he'll do? What is he going to notice? What
+                        thing hell do? What is he going to notice? What
                         is he going to ignore? What is he going to do
                         mechanically? These are all questions that
                         are as pertinent to IRC networks, programming 
                     </para>
                     <para>
                         I gave the IRC channels examples of bad UI design. OK,
-                        gurus, once upon a time there weren't too many newbies 
-                        around. But if you don't want to completely reject them,
+                        gurus, once upon a time there weren’t too many newbies 
+                        around. But if you don’t want to completely reject them,
                         it is a better idea to move to a different channel.
                     </para>
                     <para>
                         I believe the Perl Monks site also suffers from such a 
                         lacking design. First of all - its name. Do you 
-                        honestly expect someone to be a Perl "monk" and live
-                        in a Perl "monastry"? (I'm Jewish, an Atheist, and 
-                        very sexually liberated for God's sake!) Secondly,
-                        the site's design is unattrative, overcrowded and 
+                        honestly expect someone to be a Perl “monk” and live
+                        in a Perl “monastry”? (I’m Jewish, an Atheist, and 
+                        very sexually liberated for God’s sake!) Secondly,
+                        the site’s design is unattrative, overcrowded and 
                         confusing. I remember I was reluctant from 
                         participating there, and had troubles understaning
                         what it was all about.
 
                     <para>
                         Publish some of your Perl code online. Establish a 
-                        Wiki. Don't ask anybody for permission - just do it.
+                        Wiki. Dont ask anybody for permission - just do it.
                         There will be chaos first, but order will emerge out 
                         of it eventually. And if not, Google and friends will 
                         like us better. ;-)
                     </para>
                 </section>
                 <section xml:id="what_should_charge_money_say_no">
-                    <info><title>Don't be afraid to charge money or say no</title></info>
+                    <info><title>Dont be afraid to charge money or say no</title></info>
                     
                     <para>
-                        Let's suppose that despite all the positive changes and
+                        Lets suppose that despite all the positive changes and
                         having a book nearby, Mel feels she needs a face to face
                         guidance. She asks around her workplace, and discovers
                         a fellow worker, by the name of Rachel Southern (
-                        actually a character in a story I'm writing who fits 
+                        actually a character in a story Im writing who fits 
                         perfectly here) is a first-class perl guru. Rachel has
                         been programming since she was 14, knows UNIX, Perl
                         and many other languages well, and is a very nice, 
                         with work, and prefers to spend her weekends relaxing,
                         socializing (online and in real life), and hacking on 
                         open-source projects. Moreover, she lives very far
-                        from Mel's apartment. So she tells Mel that if she 
-                        wishes to go to Mel's apartment on a Saturday or a 
+                        from Mel’s apartment. So she tells Mel that if she 
+                        wishes to go to Mel’s apartment on a Saturday or a 
                         Sunday, and tutor her with Perl (or UNIX in general),
                         Mel would have to pay her a substantial amount of money
-                        per hour. Mel accepts, as she realizes the help she'll 
+                        per hour. Mel accepts, as she realizes the help shell 
                         get out of Rachel, will help her in her work, which in
                         turn will be very well worth the money.
                     </para>
                     <para>
-                        Was Rachel "greedy" or "unfriendly" in asking for 
+                        Was Rachel greedy or unfriendly in asking for 
                         money? No. I was told a technician in Israel
                         charges $50 an hour. Many lawyers and other 
                         professionals will charge much 
                         also consistently answered the E-mails of me and
                         everyone else I know, and is available by phone most
                         of the time.
-                        However, Stallman's purpose in life is propagating free
+                        However, Stallmans purpose in life is propagating free
                         software and he is the spiritual father of the free
                         software and open source movement. As such, he accepts
                         the fact that he has become a saint and does not charge
                         money for that. As he once told me and some other
-                        <link xlink:href="http://www.iglu.org.il/">IGLU</link>'ers:
-                        "Advocacy is everything I do".
+                        <link xlink:href="http://www.iglu.org.il/">IGLU</link>’ers:
+                        “Advocacy is everything I do”.
                     </para>
                     <para>
                         Most of us, however, are trying to make the best use 
                         used to help a less capable peer will cost money. It 
                         does not mean that spending some time for writing a 
                         straightforward ten-liner for someone should, though. 
-                        (in that case, there's usually no way to acquire the 
+                        (in that case, theres usually no way to acquire the 
                         money in the first place)
                     </para>
                     <para>
-                        There's a limit to anything. I remember that once
+                        Theres a limit to anything. I remember that once
                         I hanged on the IRC, and someone there showed me a
                         bot he or his clique wrote in mIRC-script and wanted
                         to convert to Perl. The bot was a bit complex, so
                         I told him I did not want to convert it, as I had
                         no selfish interest in getting it ported. I suggested
                         him to learn Perl and do the porting himself. He
-                        understood. I'm not sure the bot was ever ported, but 
+                        understood. Im not sure the bot was ever ported, but 
                         the Gods help only those that help themselves.
                     </para>
 
                         their way in. Something like 
                         <link xlink:href="http://www.python.org/">the Python 
                             Homepage</link> or 
-                        <link xlink:href="http://www.php.net/">PHP's</link>. Plain,
-                        simple and effective. (note that I don't have a problem
-                        with the O'Reilly Net format as a general rule, it's 
+                        <link xlink:href="http://www.php.net/">PHP’s</link>. Plain,
+                        simple and effective. (note that I don’t have a problem
+                        with the O’Reilly Net format as a general rule, it’s 
                         just not suitable for newbies who may have never heard
-                        of O'Reilly or do not have the time to put up with it.)
+                        of OReilly or do not have the time to put up with it.)
                         The Python.org site, for instance, contains just the 
                         right links for a newbies and nothing more. It has
                         a rather cheesy site, but it is much more usable than 
                         www.perl.com. The latter has links to a host of 
-                        other O'Reilly sites (what for), some articles that are
-                        way over Melissa's head, no explanation of what Perl is
-                        all about, links to many O'Reilly books (again: why?), 
+                        other O’Reilly sites (what for), some articles that are
+                        way over Melissa’s head, no explanation of what Perl is
+                        all about, links to many O’Reilly books (again: why?), 
                         and is generally overcrowded with information. This is
                         not a community site. It is practically a blunt 
-                        promotion of everything O'Reilly!
+                        promotion of everything OReilly!
                     </para>
                     <para>
                         www.perl.com as it is can be renamed as 
-                        perl.oreilly.com or whatever. But otherwise, O'Reilly
+                        perl.oreilly.com or whatever. But otherwise, OReilly
                         should not make a claim for the homesite of the Perl
                         language and Perl community as they are not the only
                         player in the game.
                         core Perl books to place them online. If a
                         book teaches you advanced things that you can learn on
                         your own, that do not absolutely require a book (like 
-                        Damian Conway's "Object Oriented Perl"), then putting
+                        Damian Conways Object Oriented Perl), then putting
                         it online would not be necessary, but still a nice 
-                        gesture. However, it cannot be said on "Programming 
-                        Perl" (the Camel Book), "Learning Perl" (the 
-                        Llama Book), the Perl Cookbook, or "Advanced Perl". 
-                        I could not care less however, for "Perl for Oracle 
-                        DBAs", because it's highly specialized and of no 
+                        gesture. However, it cannot be said on <emphasis>Programming 
+                            Perl </emphasis>(the Camel Book), 
+                        <emphasis>Learning Perl</emphasis> (the 
+                        Llama Book), the <emphasis>Perl Cookbook</emphasis>,
+                        or <emphasis>Advanced Perl.</emphasis> 
+                        I could not care less however, for <emphasis>Perl for 
+                            Oracle DBAs</emphasis>, because it’s highly 
+                        specialized and of no 
                         interest to Melissa or Robert. Rachel can easily learn
-                        it on her own should the need arise, and Joanna's 
+                        it on her own should the need arise, and Joannas 
                         knowledge of Perl should not extend to this 
                         speciality.
                     </para>
                         actually appeal to newbies who wish to keep up to date
                         with Perl news. What the editors should do is answer 
                         newbie submissions themselves should there be such,
-                        and <emphasis>only then</emphasis> tell them that it's
-                        the wrong place to ask. Remember, people don't read 
+                        and <emphasis>only then</emphasis> tell them that it’s
+                        the wrong place to ask. Remember, people don’t read 
                         Submission Guidelines or whatever, and even I act 
-                        mechanically on many web-sites. (don't you?)
+                        mechanically on many web-sites. (dont you?)
                     </para>
                     <para>
                         Generally, if one of the new resources would be better
                         competition either. We should not concentrate our 
                         efforts, because we will also reduce the number of 
                         people doing them in the first place. And as Eric 
-                        Raymond noted in "The Cathedral and the Bazaar", in a 
+                        Raymond noted in <emphasis>The Cathedral and the Bazaar</emphasis>, in a 
                         distributed Bazaar model, the output grows linearily 
                         to the number of people involved.
                     </para>
                     <para>
-                        While the Perl's source code was maintained in a very 
+                        While the Perls source code was maintained in a very 
                         much Bazaar-like way, the Perl Community has been
                         relatively Cathedral like looking for a selected small
-                        number of shrines. Let's change that.
+                        number of shrines. Lets change that.
                     </para>
                 </section>
             </section>
                     later on actually learn shell programming. Many Windows 
                     people who used Perl for Win32, find the UNIX concept much
                     more desirable afterwards. Perl is a reflection of UNIX in
-                    all so many ways, and I'd hate for someone to get scared
+                    all so many ways, and Id hate for someone to get scared
                     of UNIX as a result of getting scared of Perl too.
                 </para>
                 <para>
-                    You often hear people complaining at Perl's briefness,
-                    TIMTOWDIness, difficulty to learn, "inconsistency", "ugly
-                    syntax", complexity, in-fix notation, size, dollar signs,
-                    insuitability for large codebases, etc. All these "issues"
+                    You often hear people complaining at Perl’s briefness,
+                    TIMTOWDIness, difficulty to learn, “inconsistency”, 
+                    “ugly syntax”, complexity, in-fix notation, size, dollar 
+                    signs,
+                    insuitability for large codebases, etc. All these “issues”
                     are very much marginal if not completely false in getting
                     it into public acceptance.  In fact it is a sign that it
                     has a culture that not all people can accept, which is
                     However, what can deter someone from learning Perl is 
                     a lack of good support and aid from an online community,
                     which may be the only connection he has to this virtual
-                    world called "Perl". Let's change it. Let's make sure
+                    world called Perl. Lets change it. Lets make sure
                     Melissa will be practically sucked into the Perl world,
                     as any community happy to receive a shining, new, 
                     interesting member.

File t2/philosophy/perl-newcomers/v1/index.html.wml

 <h3 id="main_intro">Introduction</h3>
 
 <p>
-This is an essay I've written and published (on a different place) that
+This is an essay Ive written and published (on a different place) that
 discussed the suitability of the Perl online world for newcomers. It had
 received a lot of commentary, both supporting, and criticising.
 </p>

File t2/philosophy/philosophy/advice-for-the-young/index.html.wml

 
 #include "toc_div.wml"
 
-<latemp_subject "Shlomi Fish's Advice for the Young" />
+<latemp_subject "Shlomi Fishs Advice for the Young" />
 
 <toc_div />
 
 like you were going to live forever"</h2>
 
 <p>
-This is the single best piece of advice one could give, but you'd amazed how
-many people defy it. (It's attributed to 
+This is the single best piece of advice one could give, but you’d amazed how
+many people defy it. (It’s attributed to 
 <a href="http://en.wikipedia.org/wiki/Mahatma_Gandhi">Mahatma 
 Gandhi</a>.) Most people I know
 don’t seem to have time for anything. They are crowded with responsiblities.
-"We're too busy", they say.
+"Were too busy", they say.
 </p>
 
 <p>
-I'm not too busy, and never will be. When I worked or studied I also was never
+I’m not too busy, and never will be. When I worked or studied I also was never
 too busy to talk to people I liked or met at that time; to work on open source
 software and web sites; to relax; to help people with their computer problems.
 I became relatively popular. More people knew me by name than I could recall
 time to chat on the phone, unless they have a previous engagement. Know well
 enough that one doesn’t become productive by 
 <a href="http://www.igda.org/articles/erobinson_crunch.php">working more than 
-40 hours a week</a>, and always say "I'll do it when I have some spare 
+40 hours a week</a>, and always say "Ill do it when I have some spare 
 cycles" instead of "I don’t have time to do it."
 </p>
 
 
 <p>
 And there are people who refuse to learn anything. They don’t have time and
-think that by not learning and acquiring new skills, they'll still be
+think that by not learning and acquiring new skills, theyll still be
 successful. Java people think Java is the best thing since sliced bread and
 don’t learn Perl, Python or Ruby. C++ people don’t know how straightforward
 and painless Object-Oriented programming is in high-level languages.
 
 <p>
 Such persons are the worst. They may be pretty good at what they do, but
-they'll never get better, and will maintain their code in a language that will
+theyll never get better, and will maintain their code in a language that will
 become deprecated and then have to learn something new after not practicing
 their learning skills for a long time.
 </p>
 <p>
 Learn and Integrate the following things. By integrate, I meat take the time 
 to digest and don’t reject as absurd on the spot. Note that you have to <b>read 
-them from cover to cover</b> and not to skip in between, otherwise you'll
+them from cover to cover</b> and not to skip in between, otherwise youll
 get a lot of false impressions.
 </p>
 
 <ul>
 <li>
-Eric S. Raymond's 
+Eric S. Raymonds 
 <a href="http://www.catb.org/~esr/faqs/hacker-howto.html">How 
 to Become a Hacker</a> and
 <a href="http://www.catb.org/~esr/writings/cathedral-bazaar/">the Cathedral
 <a href="http://www.extremeprogramming.com/">Extreme Programming</a>
 </li>
 <li>
-<a href="http://www.paulgraham.com/">Paul Graham's Essays</a>
+<a href="http://www.paulgraham.com/">Paul Grahams Essays</a>
 </li>
 </ul>
 
 </p>
 
 <p>
-I'm not as 
+I’m not as 
 <a href="http://lxer.com/module/newswire/view/16376/index.html">paranoid as 
 ESR is</a> about what Microsoft will do next. I think they
 will simply embrace Linux, and port their software to run on it. 
 </p>
 
 <p>
-Why is all that important? Because you'd better learn Unix now rather than
+Why is all that important? Because youd better learn Unix now rather than
 later, knowing that it is going to be the future of computing.
 </p>
 
 </li>
 <li>
 <a href="http://www.haskell.org/">Haskell</a> and 
-<a href="http://caml.inria.fr/">O'Caml</a>
+<a href="http://caml.inria.fr/">OCaml</a>
 </li>
 <li>
-Matlab or a similar tool for bulk operations on tensors, like Perl's
-<a href="http://pdl.perl.org/">PDL</a> or Python's SciPy.
+Matlab or a similar tool for bulk operations on tensors, like Perl’s
+<a href="http://pdl.perl.org/">PDL</a> or Python’s SciPy.
 </li>
 </ul>
 
 <h2 id="growth_death">Always reverse your growth death.</h2>
 
 <p>
-Growth death means you've stopped to grow, and become more cynical as time
+Growth death means youve stopped to grow, and become more cynical as time
 goes by and less capable. It is unnecessary because some people have never
 had growth death in their entire life time, while one of my friends already 
 had it in his mid-to-late twenties. I never experienced growth death, and 
 
 <p>
 It doesn’t matter how many responsibilities you have, you never have to stop
-growing. I have been corresponding with a man in his late 70's , who is still 
+growing. I have been corresponding with a man in his late 70s , who is still 
 programming, travels a lot, is very active, and is otherwise very enthusiastic 
 about life. So he also still has a living growth.
 </p>
 <p>
 This is something that Eric S. Raymond suggests in "How to become
 a Hacker", but many people still ignore. Speaking in a language with
-many mistakes, will cause people to look down on you, and they'll
+many mistakes, will cause people to look down on you, and theyll
 immediately notice the problems in what you speak. Whenever I write something
 in either English or Hebrew, I make sure to phrase myself properly. Whenever
 I learn of a new Hebrew common mistake, I immediately register it, and notice
 Note that all-lowercase writing, while acceptable on the IRC (albeit I
 do not write this way either) is completely frowned upon in E-mails, and 
 leaves an impression of lack of professionality, no time and care to press the 
-shift key, and general disinterest. Don't do it. Putting such improperly-written
+shift key, and general disinterest. Dont do it. Putting such improperly-written
 language on the Web is even more harmful. (And often mailing lists 
 are archived on the Web for posterity).
 </p>
 <p>
 Paul Graham <a href="http://www.paulgraham.com/essay.html">recommends that 
 people learn History but not so much political
-history, but cultural, technological and artistic history</a>. He's right in a 
+history, but cultural, technological and artistic history</a>. Hes right in a 
 way. Knowing who conquered who at what time is quite useless. Knowing how 
 things developed and how people thought or behaved at the time, or what 
 happened is actually useful and enlightening.
 
 <ol>
 <li>
-Eric Raymond's <a href="http://www.catb.org/~esr/faqs/hacker-howto.html">How
-to Become a Hacker</a> - an excellent document about the hacker's way of life,
+Eric Raymond’s <a href="http://www.catb.org/~esr/faqs/hacker-howto.html">How
+to Become a Hacker</a> - an excellent document about the hacker’s way of life,
 attitude and practices.
 </li>
 <li>
-<a href="http://www.paulgraham.com/hs.html">What You'll Wish You'd Known
-- Paul Graham's Advice for High School Students</a>
+<a href="http://www.paulgraham.com/hs.html">What You’ll Wish You’d Known
+- Paul Graham’s Advice for High School Students</a>
 </li>
 <li>
-<a href="http://www.paulgraham.com/college.html">Paul Graham's Advice
+<a href="http://www.paulgraham.com/college.html">Paul Grahams Advice
 for Undergraduate College Students</a>
 </li>
 <li>
 <a href="http://www.joelonsoftware.com/articles/CollegeAdvice.html">Joel 
-Spolsky's Advice for Computer Science College Students</a>
+Spolskys Advice for Computer Science College Students</a>
 </li>
 <li>
 <a href="http://dotnetjunkies.com/WebLog/sriram/archive/2005/01/03/41183.aspx">Sriram
-Krishnan's response to Spolsky's advice</a>
+Krishnans response to Spolskys advice</a>
 </li>
 <li>
 <a href="http://www.swarthmore.edu/~apreset1/docs/if.html">"If" by Rudyard
 Kipling</a>
 </li>
 <li>
-<a href="http://www.generationterrorists.com/quotes/sunscreen.html">Everybody's
+<a href="http://www.generationterrorists.com/quotes/sunscreen.html">Everybodys
 Free (to Wear Sunscreen)</a>. Just don’t take it too seriously…
 </li>
 </ol>