Generate stored proc documentation

  • Hi,

    My friend has lots of stored procedure and are marking comments on them. I wanted to know free tools that can be used to generate documentation out of those comments.

    Is there any particular format in which the comments have to be written

    We use Sql 2005

    thanks.

  • Depending on what you want to do, how about Perl? (Try http://www.activestate.com/Products/activeperl/

    You can either create your own format or use it's POD format.

    For example:

    create procedure userproc

    as

    /*

    =head1 xproc

    =head2 Parameters

    None

    =head2 Description

    This selects a list of all users

    =cut

    */

    begin

    select * from tbluser

    end

    Then run 'pod2text xproc.sql' produces

    xproc

    Parameters

    None

    Description

    This selects a list of all users

    There's also pod2html and maybe others.

    Derek

Viewing 2 posts - 1 through 1 (of 1 total)

You must be logged in to reply to this topic. Login to reply