Stories
Slash Boxes
Comments
NOTE: use Perl; is on undef hiatus. You can read content, but you can't post it. More info will be forthcoming forthcomingly.

All the Perl that's Practical to Extract and Report

use Perl Log In

Log In

[ Create a new account ]

jonasbn (1153)

jonasbn
  reversethis-{gro.napc} {ta} {nbsanoj}
http://e-diot.dk/
AOL IM: BJonasN (Add Buddy, Send Message)

Perl Programmer located in Copenhagen, Denmark. Active member of Copenhagen Perl Mongers.

Author of:

  • Business::DK::CPR
  • Business::DK::CVR
  • Business::DK::PO
  • Business::OnlinePayment::CashCow
  • Date::Holidays
  • Date::Holidays::Abstract
  • Date::Holidays::Super
  • Date::Pregnancy
  • Games::Bingo
  • Games::Bingo::Bot
  • Games::Bingo::Print
  • Module::Info::File
  • Module::Template::Setup
  • Test::Timer

and maintainer of:

  • Tie::Tools
  • XML::Conf
  • Workflow

Journal of jonasbn (1153)

Monday June 30, 2003
04:04 PM

VB.NET, Web Services and Documentation

[ #13162 ]

VB.NET is a poor language lacking POD.

But since .NET Web Services can have a description tag, I can put HTML links in these and point to HTML pages, it requires a lot of work to write docs in HTML, but at least it is better than nothing - and you could say that the docs follow the code...

The Fine Print: The following comments are owned by whoever posted them. We are not responsible for them in any way.
 Full
 Abbreviated
 Hidden
More | Login | Reply
Loading... please wait.
  • HTML? Why? (Score:2, Insightful)

    Remember, you can still write your docs in POD, and use pod2html(1) ...
    • Yes, I am thinking about writing a POD parser for VB.NET so I will end up with autogenerated HTML :)
      • Isn't it 'just' a question of embedding POD in the .vb files, as VB comments? That way, the VB compiler will ignore it, and pod2html will already ignore anything not in =pod sections...
        • Exactly :)

          The hard part is getting people to write docs, that is a language and platform independent problem, even though Perl programmers seem to be easier to convince, perhaps this is due to the obfuscative nature of Perl?