0

我有一个示例 fortran 代码，我想在这里展示：

SUBROUTINE CALHEAT(ISTL_)  

  ! DESCRIPTION:
  !! @ details
  !> Subroutine CALHEAT takes the information from the atmospheric boundary
  !>   file and the wind forcing file and calculates the net heat flux across
  !>   the water surface boundary. 
  !
  !   The heat flux terms are derived from a paper by Rosati
  !   and Miyakoda (1988) entitled "A General Circulation Model for Upper Ocean
  !   Simulation".  The heat flux is prescribed by term for the following
  !   influxes and outfluxes:
  !
  !     - Short Wave Incoming Radiation (+)
  !     - Net Long Wave Radiation (+/-)
  !     - Sensible Heat Flux (convection -)
  !     - Latent Heat Flux (evaporation +/-)
  !
  !   Two formulations of the Latent Heat Flux are provided.  The first is from
  !   the Rosati and Miyakoda paper, the second is an alternate formulation by
  !   Brady, Graves, and Geyer (1969).  The second formulation was taken from
  !   "Hydrodynamics and Transport for Water Quality Modeling" (Martin and
  !   McCutcheon, 1999).  The Rosati and Miyakoda formulation will have zero
  !   evaporative cooling or heating if wind speed goes to zero.  The Brady,
  !   Graves, and Geyer formulation provides for a minimum evaporative cooling
  !   under zero wind speed.
  !
  ! MODIFICATION HISTORY:
  !! @author
  !>   Date       Author             Comments
  !
  !
  !! @ param[in]
  !> VARIABLE LIST:
  !>
  !>   CLOUDT  = Cloud cover (0 to 10)<BR>
  !>   HCON    = Sensible heat flux (W/m2)<BR>
  !>   HLAT    = Latent heat flux (W/m2)<BR>
  !>   HLWBR   = Net longwave radiation (atmospheric long wave plus back
  !>             radiation, W/m2)<BR>
  !>   SOLSWRT = Short wave incoming radiation (W/m2)<BR>
  !>   SVPW    = Saturation vapor pressure in mb based upon the water surface
  !>             temperature<BR>
  !>   TATMT   = Temperature of air above water surface (deg C)<BR>
  !>   TEM     = Water temperature in cell (deg C)<BR>
  !>   VPA     = Vapor pressure of air at near surface air temperature (mb)<BR>
  !>   WINDST  = Wind speed at 10 meters over cell surface (m/s)<BR>
  !--------------------------------------------------------------------------------------------------

我想使用 deoxygen 显示作者、详细信息和参数。但是，doxygen 只输出参数。谁能指出我在这里做错了什么？

示例输出如下：

在此处输入图像描述

谢谢。

4

2 回答 2

1

Doxygen使用一个特殊的命令。完整列表可以在这里找到

例如

\author { list of authors }
\param [(dir)] <parameter-name> { parameter description }

对于您的代码，请尝试以下操作：

\author Author name
\param [in] CLOUDT Cloud cover (0 to 10)
\param [in] HCON Sensible heat flux (W/m2)
\param [in] HLAT Latent heat flux (W/m2)
\param [in] HLWBR Net longwave radiation (atmospheric long wave plus back radiation, W/m2)
\param [in] SOLSWRT Short wave incoming radiation (W/m2)
\param [in] SVPW Saturation vapor pressure in mb based upon the water surface temperature
\param [in] TATMT Temperature of air above water surface (deg C)
\param [in] TEM Water temperature in cell (deg C)
\param [in] VPA Vapor pressure of air at near surface air temperature (mb)
\param [in] WINDST Wind speed at 10 meters over cell surface (m/s)
于 2013-04-17T21:32:57.503 回答
0

你必须在 SUBROUTINE 命令之前写下你的 doxygen 特定信息！有关更多信息，请参阅doxygen 手册。

于 2013-05-14T10:10:14.643 回答