Apply suggestions from code review

biogeochem/EDPhysiologyMod.F90

@@ -2851,8 +2851,8 @@ subroutine CWDInput( currentSite, currentPatch, litt, bc_in)
     integer  :: numlevsoil        ! Actual number of soil layers
 
     real(r8) :: SF_val_CWD_frac_adj(4) !SF_val_CWD_frac adjusted based on cohort dbh
-    real(r8) :: leaf_herbivory
-    real(r8) :: herbivory_element_use_efficiency
+    real(r8) :: leaf_herbivory  ! leaf that is eaten by grazers [kg]
+    real(r8) :: herbivory_element_use_efficiency   ! fraction of grazed biomass that is returned to litter pool versus atmosphere
     !----------------------------------------------------------------------
 
     ! -----------------------------------------------------------------------------------

parteh/PRTLossFluxesMod.F90

@@ -893,11 +893,12 @@ subroutine PRTHerbivoryLosses(prt, organ_id, mass_fraction)
 
     ! ----------------------------------------------------------------------------------
     ! This subroutine assumes that there is no re-translocation associated
-    ! with herbivory. There is only one destiny for eaten mass within
-    ! the organ, and that is outside the plant.  
-    ! It is also assumed that non PARTEH parts of the code (ie the grazing-model)
-    ! will decide what to do with the consumed mass (i.e. sent it to the litter
-    ! pool or send to atmosphere)
+    ! with herbivory. There are two pathways for grazed matter. Some fraction 
+    ! is lost from the land system (i.e. to the atmosphere via respiration or gas-phase 
+    ! nutrient loss pathways), and some fraction is passed to litter decomposition 
+    ! (i.e. via manure or grazer mortality). These pathways of consumed biomass 
+    ! are handled outside PARTEH (e.g., the litter flux is handled in EDPhysiologyMod, 
+    ! and controlled by element-specific "use efficiency" parameters).
     ! ----------------------------------------------------------------------------------
 
     class(prt_vartypes) :: prt