@@ -45,7 +45,7 @@ not worry! An important skill for a computer scientist is to learn what
 to ignore and what to look at carefully. You will soon find that there
 are some elements of Java that will fade into the background as you
 become used to seeing them. One thing that will help you is to learn a
-little bit about Java [sec:naming\_conventions] {Naming Conventions}.
+little bit about Java `Naming Conventions <namingconventions.html>`_.
 
 The first question you probably have about this little program is “How
 do I run it?” Running a Java program is not as simple as running a
@@ -70,7 +70,7 @@ The command ``javac`` compiles our java source code into compiled byte
 code and saves it in a file called ``Hello.class``. ``Hello.class`` is a
 binary file so you won’t learn much if you try to examine the class file
 with an editor. Hopefully you didn’t make any mistakes, but if you did
-you may want to consult the [sec:common\_mistakes] {Common Mistakes}
+you may want to consult the `Common Mistakes <commonmistakes.html>`_
 section for helpful hints on compiler errors.
 
 Now that we have compiled our java source code we can run the compiled
 
@@ -176,7 +176,7 @@ variable. If you have ever tried to use a Python variable that you have
 not initialized the second error message will be familiar to you. The
 difference here is that we see the message before we ever try to test
 our program. More common error messages are discussed in the section
-[sec:common\_mistakes] {Common Mistakes}.
+`Common Mistakes <commonmistakes.html>`_.
 
 The general rule in Java is that you must decide what kind of an object
 your variable is going to reference and then you must declare that
 
@@ -2,8 +2,6 @@
 Naming Conventions
 ==================
 
-{sec:naming\_conventions}
-
 Java has some very handy naming conventions.
 
 -  Class names always start with an upper case letter. For example,