##############################################################################
###+------+###################################################################
#+-| LN() |-------------------------------------------+#######################
#| +------+ Returns the natural logarithm of argument |#######################
#+----------------------------------------------------+#######################
##############################################################################
##############################################################################
#+--| Summary |--------------+################################################
#|     #INCLUDE math.hdr     |################################################
#+---------------------------+################################################
##############################################################################
##############################################################################
#+--| Syntax |----------------------------+###################################
#|     FUNCTION DBL ln PROTOTYPE          |###################################
#|      PARAMETERS CONST DBL argument     |###################################
#+----------------------------------------+###################################
##############################################################################
##############################################################################
###########+---| Description |------------------------------------+###########
###########| The ln() function returns the natural logarithm of   |###########
###########| argument.  ln(y) returns x where y=exp(x).  The ln() |###########
###########| function is defined only over the domain y > 0.      |###########
###########| ---------------------------------------------------- |###########
###########| The value of e, 2.1828..., is defined in math.hdr    |###########
###########+------------------------------------------------------+###########
##############################################################################
##############################################################################
#########+--| Example 1 |-------------------------------------------+#########
#########| *    Print the natural log of 10.                        |#########
#########|                                                          |#########
#########| y = ln(10.0) / ln( &e ) * ln( x )                        |#########
#########| ? y                                                      |#########
#########+----------------------------------------------------------+#########
##############################################################################
##############################################################################
#########+--| Example 2 |-------------------------------------------+#########
#########| *    Calculate whether a chemical reaction will occur.   |#########
#########|                                                          |#########
#########| delta_g = - R * T ln( K )                                |#########
#########+----------------------------------------------------------+#########
##############################################################################