Changeset 133 for trunk/SRC/Calendar/caldat.pro

Timestamp:

07/07/06 11:57:27 (18 years ago)

Author:

navarro

Message:

english and nicer header (1)

File:

• trunk/SRC/Calendar/caldat.pro (moved) (moved from trunk/SRC/ToBeReviewed/CALENDRIER/caldat.pro) (2 diffs)

trunk/SRC/Calendar/caldat.pro

@@ -1 @@
-; $Id$
+;+
 ;
-; Copyright (c) 1992-2003, Research Systems, Inc.  All rights reserved.
-;       Unauthorized reproduction prohibited.
-;
-
-;+
-; NAME:
-;       CALDAT
-;
-; PURPOSE:
+; @file_comments
 ;       Return the calendar date and time given julian date.
 ;       This is the inverse of the function JULDAY.
-; CATEGORY:
-;       Misc.
+; 
+; @categories Calendar
 ;
-; CALLING SEQUENCE:
-;       CALDAT, Julian, Month, Day, Year, Hour, Minute, Second
-;       See also: julday, the inverse of this function.
 ;
-; INPUTS:
-;       JULIAN contains the Julian Day Number (which begins at noon) of the
+; @param JULIAN {in}{required} contains the Julian Day Number (which begins at noon) of the
 ;       specified calendar date.  It should be a long integer.
-; OUTPUTS:
-;       (Trailing parameters may be omitted if not required.)
-;       MONTH:  Number of the desired month (1 = January, ..., 12 = December).
 ;
-;       DAY:    Number of day of the month.
+; @param MONTH {out} Number of the desired month (1 = January, ..., 12 = December).
 ;
-;       YEAR:   Number of the desired year.
+; @param DAY {out} Number of day of the month.
 ;
-;       HOUR:   Hour of the day
-;       Minute: Minute of the day
-;       Second: Second (and fractions) of the day.
+; @param YEAR {out} Number of the desired year.
 ;
-; KEYWORD PARAMETERS:
+; @param HOUR {out} Hour of the day
 ;
-;       NDAYSPM: for using a calendar with fixed number of days per
-;                months. defaut value of NDAYSPM=30
+; @param Minute {out} Minute of the day
 ;
-; COMMON BLOCKS: cm_4cal
+; @param Second {out} Second (and fractions) of the day.
 ;
-; SIDE EFFECTS:
-;       None.
 ;
-; RESTRICTIONS:
-;       Accuracy using IEEE double precision numbers is approximately
+; @keyword NDAYSPM {default=30} for using a calendar with fixed number of days per
+;                months.
+;
+; @uses cm_4cal
+;
+;
+; @restrictions Accuracy using IEEE double precision numbers is approximately
 ;       1/10000th of a second.
 ;
-; MODIFICATION HISTORY:
-;       Translated from "Numerical Recipies in C", by William H. Press,
+; @history Translated from "Numerical Recipies in C", by William H. Press,
 ;       Brian P. Flannery, Saul A. Teukolsky, and William T. Vetterling.
 ;       Cambridge University Press, 1988 (second printing).
@@ -61 +45 @@
 ;
 ;       AB, 3 January 2000, Make seconds output as DOUBLE in array output.
+;
+; @version $Id$
 ;-
-;
 pro CALDAT, julian, month, day, year, hour, minute, second, NDAYSPM = ndayspm
 ;------------------------------------------------------------