diff --git a/doc/libvips-docs.xml.in b/doc/libvips-docs.xml.in
index a72c7bac..beeb7728 100644
--- a/doc/libvips-docs.xml.in
+++ b/doc/libvips-docs.xml.in
@@ -7,26 +7,26 @@
 ]>
 <book id="index">
   <bookinfo>
-    <title>VIPS Reference Manual</title>
+    <title>libvips Reference Manual</title>
     <releaseinfo>
-      For VIPS @VIPS_VERSION@.
+      For libvips @VIPS_VERSION@.
       The latest version of this documentation can be found on the 
       <ulink role="online-location"
-        url="http://libvips.github.io/libvips/API/current/">VIPS website</ulink>.
+        url="http://libvips.github.io/libvips/API/current/">libvips website</ulink>.
     </releaseinfo>
   </bookinfo>
 
   <chapter>
-    <title>VIPS Overview</title>
+    <title>libvips Overview</title>
     <para>
-      VIPS is a free image processing system. It is good with large 
+      libvips is a free image processing system. It is good with large 
       images (images larger than the amount of RAM you have available), with 
       many CPUs (speed scales linearly to at least 32 threads), for working 
       with colour, for scientific analysis and for general research 
       and development. As well as JPEG, TIFF and PNG images, it also 
       supports scientific formats like FITS, Matlab, Analyze, PFM, 
       Radiance and OpenSlide. It works on many UNIX-like platforms,
-      as well as Windows and OS X. VIPS is released under the GNU Library
+      as well as Windows and OS X. libvips is released under the GNU Library
       General Public License (GNU LGPL).
     </para>
 
@@ -47,7 +47,7 @@
   </chapter>
 
   <chapter>
-    <title>Core VIPS API</title>
+    <title>Core libvips API</title>
     <xi:include href="xml/vips.xml"/>
     <xi:include href="xml/image.xml"/>
     <xi:include href="xml/header.xml"/>
@@ -67,7 +67,7 @@
   </chapter>
 
   <chapter>
-    <title>VIPS operation API by section</title>
+    <title>libvips operation API by section</title>
     <xi:include href="xml/arithmetic.xml"/>
     <xi:include href="xml/colour.xml"/>
     <xi:include href="xml/conversion.xml"/>
diff --git a/doc/libvips-from-C++.md b/doc/libvips-from-C++.md
index 77abbd93..02469f69 100644
--- a/doc/libvips-from-C++.md
+++ b/doc/libvips-from-C++.md
@@ -13,5 +13,5 @@ libvips comes with a convenient C++ API. It is a very thin wrapper over the
 C API and adds automatic reference counting, exceptions, operator 
 overloads, and automatic constant expansion. 
 
-The documentation for this API is in a [separate section of the
-website](/libvips/API/current/cpp). 
+The documentation for this API is in a [different part of the
+website](https://libvips.github.io/libvips/API/current/cpp).
diff --git a/doc/libvips-from-C++.xml b/doc/libvips-from-C++.xml
index 242e9d71..b0f00097 100644
--- a/doc/libvips-from-C++.xml
+++ b/doc/libvips-from-C++.xml
@@ -14,7 +14,7 @@
   libvips comes with a convenient C++ API. It is a very thin wrapper over the C API and adds automatic reference counting, exceptions, operator overloads, and automatic constant expansion.
 </para>
 <para>
-  The documentation for this API is in a <link xlink:href="/libvips/API/current/cpp">separate refsect3 of the website</link>.
+  The documentation for this API is in a <link xlink:href="https://libvips.github.io/libvips/API/current/cpp">different part of the website</link>.
 </para>