Beefy Boxes and Bandwidth Generously Provided by pair Networks
Perl Monk, Perl Meditation
 
PerlMonks  

where to edit man pages for perl?

by toro (Beadle)
on Jul 29, 2012 at 06:22 UTC ( #984267=perlquestion: print w/replies, xml ) Need Help??
toro has asked for the wisdom of the Perl Monks concerning the following question:

One of the perl tutorials I'm reading contains some potentially offensive language. I'd like to propose a small edit that wouldn't change the thrust of the lesson and might reduce the potential to offend some who might read it.

Where can I go to suggest the edit?

Replies are listed 'Best First'.
Re: where to edit man pages for perl?
by Anonymous Monk on Jul 29, 2012 at 07:08 UTC
    You will not be able to directly edit anything, but you can create and submit a patch and hope the powers that be approve and commit it. The Perl git repository is here: http://perl5.git.perl.org/perl.git
      Thanks, anon!
Re: where to edit man pages for perl?
by toolic (Bishop) on Jul 29, 2012 at 11:49 UTC
      Thank you toolic, I was unaware of that resource.
Re: where to edit man pages for perl?
by CountZero (Bishop) on Jul 29, 2012 at 06:24 UTC
    And which one tutorial that might be?

    CountZero

    A program should be light and agile, its subroutines connected like a string of pearls. The spirit and intent of the program should be retained throughout. There should be neither too little or too much, neither needless loops nor useless variables, neither lack of structure nor overwhelming rigidity." - The Tao of Programming, 4.1 - Geoffrey James

    My blog: Imperial Deltronics

      Perhaps all those "Hello World" examples are offensive to some?

      perl -E'sub Monkey::do{say$_,for@_,do{($monkey=[caller(0)]->[3])=~s{::}{ }and$monkey}}"Monkey say"->Monkey::do'
        Indeed, as an atheist I would like to be greeted with "WorldO"!

        CountZero

        A program should be light and agile, its subroutines connected like a string of pearls. The spirit and intent of the program should be retained throughout. There should be neither too little or too much, neither needless loops nor useless variables, neither lack of structure nor overwhelming rigidity." - The Tao of Programming, 4.1 - Geoffrey James

        My blog: Imperial Deltronics
      I would rather not get into it on perlmonks. Such discussions never go well.
        I just wanted to know because I am preparing a Perl course to be taught within the company I am working and I would like to avoid any embarrassment. I am working for an American company and they can have some weird views on what is offensive or not. But do send me a personal message if you'd rather not bring it out in the open.

        CountZero

        A program should be light and agile, its subroutines connected like a string of pearls. The spirit and intent of the program should be retained throughout. There should be neither too little or too much, neither needless loops nor useless variables, neither lack of structure nor overwhelming rigidity." - The Tao of Programming, 4.1 - Geoffrey James

        My blog: Imperial Deltronics

        I would rather not get into it on perlmonks. Such discussions never go well.

        Might as well, FWIW, any suggested change you make is public, and it will get discussed

        I found nothing in the tutorials with  use Regexp::Common qw /profanity/; but I did find these :)

        perl\dump.c : 1285 : crap perl\Porting\epigraphs.pod : 35 : crap perl\Porting\make_snapshot.pl : 8 : crap perl\os2\Changes : 166 : hard on perl\vms\vms.c : 12147 : hard on perl\vms\vms.c : 13500 : hard on perl\cpan\CGI\Changes : 1391 : crapping perl\cpan\CPAN\Changes : 75 : crap perl\t\re\re_tests : 1098 : crap perl\t\re\re_tests : 1098 : crap perl\cpan\Archive-Tar\lib\Archive\Tar.pm : 498 : crappy perl\cpan\ExtUtils-MakeMaker\t\lib\MakeMaker\Test\NoXS.pm : 13 : crap perl\cpan\Module-Build\lib\Module\Build\Platform\MacOS.pm : 25 : crap
Re: where to edit man pages for perl?
by Your Mother (Chancellor) on Jul 29, 2012 at 19:41 UTC

    -- -- -- -- --, sadly I can only apply one. Unless there’s a Holocaust joke I missed in the tuts leave the potential offense alone. I guarantee everything offends someone, even, as already mentioned, “Hello world.” It’s not potentially stupid or potentially the fault of the offended in this and many other cases.

      Your Mother, it seems like you judged my opinion without first knowing what it was.

      Why is there an exception for Holocaust jokes?

      This statement of yours in particular:

      It’s not potentially stupid or potentially the fault of the offended in this and many other cases.
      seems particularly unjust. Just sub in some bigotry or racial name-calling or depictions you disapprove of (e.g. by American whites against African-Americans) and ask if it's the fault of the offended.

        There is never an exception for Holocaust jokes, was the point. It's one of the only places I'd say the line is indisputable. Which leads me to say the line is usually disputable. Which leads me to say that it's important to err on the side of expression, not on the side of repression.

        You previously stated that you wouldn't reveal your issue because "Such discussions never go well (on PerlMonks)." This leads to one of the following, 1) you think most of us are irrational, 2) you know your point to be weak and open to critique.

        I doubt you think your point is weak so you see how I could now potentially take offense. You've implied I'm irrational and maybe even a racist since I'd personally probably veto any self-censoring editorial.

        Of course without citation this is all very academic and silly, just like taking offense for things that simply aren't true and certainly weren't intended.

        Update: I just saw the s/Ahmed/Zed/ from a bit earlier. I wouldn't have kvetched about that though I do think it's silly. Secrecy is no one's friend. As it is impossible to legislate and regulate thoughts, so is it ridiculous and counter-productive to legislate and regulate their expression in words. You can't make people cease to be racist but you can make them resentful and secretive about it.

Re: where to edit man pages for perl?
by Jenda (Abbot) on Aug 01, 2012 at 15:11 UTC

    All this whimpering about offensive language is offending me to no end! I file a complaint and request such statements are removed!

    Jenda
    Enoch was right!
    Enjoy the last years of Rome.

Log In?
Username:
Password:

What's my password?
Create A New User
Node Status?
node history
Node Type: perlquestion [id://984267]
Approved by tobyink
help
Chatterbox?
and all is quiet...

How do I use this? | Other CB clients
Other Users?
Others making s'mores by the fire in the courtyard of the Monastery: (6)
As of 2017-11-19 01:01 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?
    In order to be able to say "I know Perl", you must have:













    Results (278 votes). Check out past polls.

    Notices?