Hi!

I would suggest introduce an new tag into current NF format: $LASTREVISION$

This would contain the ID of the last time the documentation of a
function / procedure was compared with the original source. Thus, we
could quickly compare the functions which are outdated and need
revision.

A simple example would be:

/*  $DOC$
 *  $TEMPLATE$
 *      Function
 *  $NAME$
 *      ERRORSYS()
 *  $CATEGORY$
 *      API
 *  $SUBCATEGORY$
 *      Error
 *  $ONELINER$
 *      Install default error handler
 *  $SYNTAX$
 *      ERRORSYS() --> NIL
 *  $ARGUMENTS$
 *      None.
 *  $RETURNS$
 *      ERRORSYS() always return NIL.
 *  $DESCRIPTION$
 *      ERRORSYS() is called upon startup by Harbour and installs the default
 *      error handler. Normally you should not call this function directly,
 *      instead use ERRORBLOCK() to install your own error handler.
 *  $STATUS$
 *      R
 *  $COMPLIANCE$
 *      C
 *  $FILES$
 *      Library is rtl
 *  $SEEALSO$
 *      ERRORBLOCK(),Error class
 *  $LASTREVISION$
 *      11685 2009-07-09 21:22:22Z vszakats
 *  $END$
 */

What do you think?

Regards,
Vailton Renato
_______________________________________________
Harbour mailing list (attachment size limit: 40KB)
Harbour@harbour-project.org
http://lists.harbour-project.org/mailman/listinfo/harbour

Reply via email to