diff --git a/doc/guide/plovasp.rst b/doc/guide/plovasp.rst
index a53b1ba3..8949ba79 100644
--- a/doc/guide/plovasp.rst
+++ b/doc/guide/plovasp.rst
@@ -1,7 +1,7 @@
 .. _plovasp:
 
-PLOVasp input file
-==================
+PLOVasp
+=======
 
 The general purpose of the PLOVasp tool is to transform
 raw, non-normalized projectors generated by VASP into normalized
@@ -105,7 +105,7 @@ the local states:
 *  **TRANSFILE** (string): name of the file containing transformation
    matrices for each site. This option allows for a full-fledged functionality
    when it comes to local state transformations. The format of this file
-   is described in :ref:`_transformation_file`.
+   is described in :ref:`transformation_file`.
 
 Section [Group]
 """""""""""""""
@@ -134,7 +134,7 @@ Optional group parameters:
    on different sites included in the group will be orthogonal to each other.
    
 
-.. _transformation_file
+.. _transformation_file:
 
 File of transformation matrices
 """""""""""""""""""""""""""""""
diff --git a/doc/vasp/source/plotools.rst b/doc/vasp/source/plotools.rst
index b9fe5d52..61d99513 100644
--- a/doc/vasp/source/plotools.rst
+++ b/doc/vasp/source/plotools.rst
@@ -46,7 +46,7 @@ electronic structure data. At this stage simple consistency checks are performed
 
 All electronic structure from VASP is stored in a class ElectronicStructure:
 
-.. autoclass:: elstruct.ElectronicStructure
+.. autoclass:: triqs_dft_tools.converters.plovasp.elstruct.ElectronicStructure
    :members:
 
 
@@ -95,7 +95,7 @@ Order of operations:
     * distribute back the arrays assuming that the order is preserved
     
 
-.. autoclass:: proj_shell.ProjectorShell
+.. autoclass:: triqs_dft_tools.converters.plovasp.proj_shell.ProjectorShell
    :members:
 
 
diff --git a/doc/vasp/source/vaspio.rst b/doc/vasp/source/vaspio.rst
index 4cadd5c1..b8d568cf 100644
--- a/doc/vasp/source/vaspio.rst
+++ b/doc/vasp/source/vaspio.rst
@@ -1,4 +1,4 @@
-.. sec_vaspio
+.. _vaspio:
 
 VASP input-output
 #################