Re: Learning perl - for experienced programmers

cartercc@xxxxxxxxx wrote:

John Bokma wrote:
My oh my, weren't you the one who wasn't aware of POD? If you think
that "the industry" selects a language because it's well fitted for
the tasks at hand you are more then naive.

John, I don't want this to sound ugly. I had decided to ignore your
remark. I formed the conclusion that you had no idea what you were
talking about.

Funny, maybe read the other replies, which probably do it better then I
can do.

The javadoc utility produces a Java API of your code. You can write an
application, run javadoc, and WITHOUT ANY FURTHER EFFORT ON THE
PROGRAMMER'S PART have a full API of your application. POD is an HTML
type

Like I said: you have to read more on POD. Also, it sounds like you have
little experience with javadoc. Maybe you should closely examine the
source that comes with a JDK install and count the number of lines that
have comment and wonder aloud why someone has been typing that. Next,
wonder how useful "your" javadoc is for pratical purposes after deleting
all those comments.

[ rest snipped, couldn't be bothered ]

--
John Experienced Perl programmer: http://castleamber.com/

Perl help, tutorials, and examples: http://johnbokma.com/perl/
.

Relevant Pages

  • Re: Decouple Javadoc from Java
    ... Javadoc clutters Java code! ... Java is a language that can be reasoned about mathematically (erm, ... To expect a programmer to be a wordsmith.. ...
    (comp.lang.java.help)
  • confused about POD
    ... This might be just a mental glitch, but I seem to be having a problem ... documation (in Javadoc format) by running a command. ... If I document my Perl code using POD ... what command do I run to produce a series of HTML ...
    (comp.lang.perl.misc)
  • Re: confused about POD
    ... me to produce HTML documentation of Java classes from internal ... documation (in Javadoc format) by running a command. ... If I document my Perl code using POD ... what command do I run to produce a series of HTML ...
    (comp.lang.perl.misc)
  • Re: Decouple Javadoc from Java
    ... by which I'm guessing you mean "keeping Javadoc comments *with* the ... damage to the source files containing it, ... Programmers should not be ignorant of correct use of natural ... Lack of rigor in use of natural language bespeaks lack of ...
    (comp.lang.java.help)
  • Re: Decouple Javadoc from Java
    ... Javadoc clutters Java code! ... Describing an unambiguous language ... And by deleting the doc comments, you have ruined the code for everyone except the programmer. ...
    (comp.lang.java.help)