diff --git a/doc/Section_start.html b/doc/Section_start.html
index 50d60cc0a5..e24bd54193 100644
--- a/doc/Section_start.html
+++ b/doc/Section_start.html
@@ -327,9 +327,11 @@ meam directory with the appropriate Makefile, e.g. "make -f
Makefile.icc". If one of the provided Makefiles is not appropriate
for your system you can edit or add one as needed.
-Linking a Fortran library to a C++ code can be problematic
-(e.g. non-matching underscore conventions). If you have problems with
-a particular compiler/machine, please send an email to the developers.
+
Note that linking a Fortran library to a C++ code can be problematic
+(e.g. Fortran routine names can't be found due to non-standard
+underscore rules) and typically requires additional C++ or F90
+libraries be included in the link. You may need to read documentation
+for your compiler about how to do this correctly.
2.4 Building LAMMPS as a library
diff --git a/doc/Section_start.txt b/doc/Section_start.txt
index 3c30daacc7..7c9fafc7f6 100644
--- a/doc/Section_start.txt
+++ b/doc/Section_start.txt
@@ -320,9 +320,11 @@ meam directory with the appropriate Makefile, e.g. "make -f
Makefile.icc". If one of the provided Makefiles is not appropriate
for your system you can edit or add one as needed.
-Linking a Fortran library to a C++ code can be problematic
-(e.g. non-matching underscore conventions). If you have problems with
-a particular compiler/machine, please send an email to the developers.
+Note that linking a Fortran library to a C++ code can be problematic
+(e.g. Fortran routine names can't be found due to non-standard
+underscore rules) and typically requires additional C++ or F90
+libraries be included in the link. You may need to read documentation
+for your compiler about how to do this correctly.
2.4 Building LAMMPS as a library :h4,link(2_4)