Beefy Boxes and Bandwidth Generously Provided by pair Networks
Welcome to the Monastery
 
PerlMonks  

Re: Another day, another nit

by merlyn (Sage)
on Dec 20, 2005 at 16:59 UTC ( [id://518120]=note: print w/replies, xml ) Need Help??


in reply to Another day, another nit

Keep in mind that chromatic, like me, writes for at least part of his living, and is also a technical editor at least part of the time (like me). We have a different level of sensitivity about agreed-upon spellings and terminologies as a natural result of our attempt to make many different writers look consistent.

I suspect that chromatic and the O'Reilly staff have already created some style guidelines for books about Perl 6, and somewhere on this list it says "Perl 6, not Perl6". While this may appear arbitary to some, it will nevertheless define the way that all official texts from O'Reilly will appear. And dare I say, as O'Reilly goes, so goes the community. {grin}

The whole distinction between "perl" and "Perl" was a similar declaration on my part during the writing of the initial Camel. I told Larry that the name of the language "disappears" when it is in the middle of the sentence, and we agreed that we could call the language Perl, and the interpreter perl (in a constant font), so that neither of them would disappear in text.

Was this completely justified in an absolute sense? Not really. It's a style decision for typographical reasons, but it also defined how an entire generation of people spelled both.

So, ease up on chromatic. He's probably quoting chapter and verse of a style guide that has been defined and agreed upon. Because of that, it'll also be how every "official" doc appears, and if you write it differently, people may understand what you mean, but they'll wonder why you're typing it differently.

-- Randal L. Schwartz, Perl hacker
Be sure to read my standard disclaimer if this is a reply.

Replies are listed 'Best First'.
Re^2: Another day, another nit
by jdporter (Paladin) on Dec 20, 2005 at 17:13 UTC
    ... a style guide that has been defined and agreed upon

    Binding on O'Reilly authors, perhaps, but not on PerlMonks.

      Uh, what part of what I said would disagree with that? Not sure why you're trying to make a point here.

      Sure, it's an O'Reilly standard. But I'm free to suggest to you that you also use the same standard here. You're free to reject it. What's your point?

      -- Randal L. Schwartz, Perl hacker
      Be sure to read my standard disclaimer if this is a reply.

        Just making the point for the sake of making it. For posterity, let's say. I appreciate the factual information you provided.

A reply falls below the community's threshold of quality. You may see it by logging in.

Log In?
Username:
Password:

What's my password?
Create A New User
Domain Nodelet?
Node Status?
node history
Node Type: note [id://518120]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this?Last hourOther CB clients
Other Users?
Others avoiding work at the Monastery: (5)
As of 2024-03-29 07:14 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found