Click above to get retro games delivered to your door ever month!

                This example shows how you would set up the
               headers for either a Clipper or C source file.

/*
 * File......: PRTSCR.C
 * Author....: Ted Means
 * CIS ID....: 73067,3332
 * Date......: $Date$
 * Revision..: $Revision$
 * Log file..: $Logfile$
 *
 * This is an original work by Ted Means and is placed in the
 * public domain.
 *
 * Modification history:
 * ---------------------
 *
 * $Log$
 *
 */

/*  $DOC$
 *  $FUNCNAME$
 *     FT_PrtScr()
 *  $ONELINER$
 *     Enable or disable printscreens
 *  $SYNTAX$
 *     FT_PrtScr( <lSetStat> ) -> lCurStat
 *  $ARGUMENTS$
 *     <lSetStat> set to .T. will enable printscreens, .F. will
 *     disable printscreens.
 *  $RETURNS$
 *     The current state ( .T. for enabled, .F. for disabled).
 *  $DESCRIPTION$
 *     This function is valuable if you have a need to disable the
 *     printscreen key.  It works by fooling the BIOS into thinking
 *     that a printscreen is already in progress.  The BIOS will then
 *     refuse to invoke the printscreen handler.
 *  $EXAMPLES$
 *     FT_PrtScr( .F. )       // Disable the printscreen key
 *     FT_PrtScr( .T. )       // Enable the printscreen key
 *     MemVar := FT_PrtScr()  // Get the current status
 *  $INCLUDE$
 *     FTVIDEO.CH
 *  $SEEALSO$
 *     ft_peek() ft_poke()
 *  $END$
 */

                        Formatting Guidelines
/*
 * File......: PRTSCR.C
 * Author....: Ted Means
 * CIS ID....: 73067,3332
 * Date......: $Date$          <- Leave blank, for librarian's use
 * Revision..: $Revision$      <-    "
 * Log file..: $Logfile$       <-    "
 *
 * This is an original work by Ted Means and is placed in the
 * public domain.
 *
 * Modification history:
 * ---------------------
 *                              +
 * $Log$                        | Leave blank, for librarian's use
 *                              +
 */

/*  $DOC$
 *  $FUNCNAME$
  +--------------- indent all items 6 spaces after asterisk
 * +   FT_PRTSCR()                           <- 15 characters MAXIMUM
 * |$ONELINER$
 * |   Enable or disable printscreens        <- 60 character MAXIMUM
 * |$SYNTAX$
 * |   FT_PRTSCR( <lSetStat> ) -> lCurStat
 * |$ARGUMENTS$ +------------------- Parameters in angle brackets
 * |   <lSetStat> set to .T. will enable printscreens, .F. will
 * |   disable printscreens.
 * |$RETURNS$
 * |   The current state ( .T. for enabled, .F. for disabled).
 * |$DESCRIPTION$
 * |   This function is valuable if you have a need to disable the
 * |   printscreen key.  It works by fooling the BIOS into thinking
 * |   that a printscreen is already in progress.  The BIOS will then
 * |   refuse to invoke the printscreen handler.
   |   +------------- Lines no longer than 65 characters --------------+
 * |$EXAMPLES$
 * |   FT_PRTSCR( .F. )       // Disable the printscreen key
 * |   FT_PRTSCR( .T. )       // Enable the printscreen key
 * |   MemVar := FT_PRTSCR()  // Get the current status
 * |$INCLUDE$
 * |   FTVIDEO.CH                            <- optional
 * |$SEEALSO$
 * |   FT_PEEK() FT_POKE()                   <- optional
 * |$END$
 */|
   +- Function names in all caps