Procedure

     DASDC    ( DAS delete comments )

     SUBROUTINE DASDC ( HANDLE )

Abstract

     Delete the entire comment area of a previously opened binary
     DAS file.

Required_Reading

     DAS

Keywords

     None.

Declarations

     IMPLICIT NONE

     INTEGER               HANDLE

Brief_I/O

     VARIABLE  I/O  DESCRIPTION
     --------  ---  --------------------------------------------------
     HANDLE     I   The handle of a binary DAS file opened for writing.

Detailed_Input

     HANDLE   is the handle of a binary DAS file that is to have its
              entire comment area deleted. The DAS file should have
              been opened with write access.

Detailed_Output

     None.

Parameters

     None.

Exceptions

     1)  If the binary DAS file attached to HANDLE is not open with
         write access, an error is signaled by a routine in the call
         tree of this routine.

Files

     See argument HANDLE in $Detailed_Input.

Particulars

     Binary DAS files contain an area which is reserved for storing
     annotations or descriptive textual information about the data
     contained in a file. This area is referred to as the ``comment
     area'' of the file. The comment area of a DAS file is a line
     oriented medium for storing textual information. The comment area
     preserves any leading or embedded white space in the line(s) of
     text which are stored, so that the appearance of the information
     will be unchanged when it is retrieved (extracted) at some other
     time. Trailing blanks, however, are NOT preserved, due to the way
     that character strings are represented in standard Fortran 77.

     This routine will delete the entire comment area from the binary
     DAS file attached to HANDLE. The size of the binary DAS file will
     remain unchanged. The space that was used by the comment records
     is reclaimed.

Examples

     Let

           HANDLE   be the handle for a DAS file which has been opened
                    with write access.

     The call

           CALL DASDC ( HANDLE )

     will delete the entire comment area of the binary DAS file
     attached to HANDLE.

Restrictions

     None.

Literature_References

     None.

Author_and_Institution

     N.J. Bachman       (JPL)
     J. Diaz del Rio    (ODC Space)
     K.R. Gehringer     (JPL)

Version

    SPICELIB Version 1.1.0, 02-JUN-2021 (JDR)

        Added IMPLICIT NONE standard.

        Edited the header to comply with NAIF standard. Removed
        unnecessary $Revisions section.

    SPICELIB Version 1.0.2, 11-NOV-2016 (NJB)

        Fixed typo in $Particulars header section.

    SPICELIB Version 1.0.1, 26-OCT-1993 (KRG)

        Changed the $Brief_I/O description of handle. It now mentions
        that the file must be open for writing. Also added a statement
        to the $Detailed_Input section to the effect that the DAS file
        should have been opened with write access.

    SPICELIB Version 1.0.0, 24-NOV-1992 (KRG)