in reply to Need your advice on how to start a program

I like localising documentation, in particular I like to write documentation for a function immediately before the function itself. It helps when you have to figure out what it does, and when you make modifications you should also remember to update docs more easily.

Flavio (perl -e 'print(scalar(reverse("\nti.xittelop\@oivalf")))')

Don't fool yourself.
  • Comment on Re: Need your advice on how to start a program

Replies are listed 'Best First'.
Re^2: Need your advice on how to start a program
by osunderdog (Deacon) on May 05, 2005 at 16:39 UTC

    I agree with this in theory, however in practice, interleaving code and pod comments messes up colorization in my favorite editor (emacs). I assume that it does in other editors as well. Do you have a work around or know of editors that don't exhibit this problem?

    Soon to be unemployed!

[reply]

      vim has no trouble with highlighting pod blocks. The (few) other editors I've tried didn't have a problem with it, komodo, anjuta, jedit, dzsoft, and a couple others.

      --
      naChoZ

      Where in the nursery rhyme does it say Humpty Dumpty is an egg?

[reply]
      Sorry to come back to this post only now, I thought I already answered this morning! I even added the emacs and cperl version as an update... on another post :)

      The only problem I have with pod colorising in cperl is that it's quite slow to be triggered, but it works well for me. I'm running emacs 21.2.2 (Slackware 9 default) with the standard provided cperl.

      Flavio (perl -e 'print(scalar(reverse("\nti.xittelop\@oivalf")))')

      Don't fool yourself.
[reply]
      What version of emacs are you using? Colorizing POD works fine for me with emacs-21 on solaris and freebsd.
[reply]

In Section Seekers of Perl Wisdom