Merge pull request #4914 from alexet/fix-spec-bugs

QL Language specification. Fix multiple spec bugs.

Author: alexet

docs/codeql/ql-language-reference/about-the-ql-language.rst

@@ -44,7 +44,7 @@ When you write this process in QL, it closely resembles the above structure. Not
 For more information about the important concepts and syntactic constructs of QL, see the individual reference topics such as ":doc:`Expressions <expressions>`" and ":doc:`Recursion <recursion>`."
 The explanations and examples help you understand how the language works, and how to write more advanced QL code.
 
-For formal specifications of the QL language and QLDoc comments, see the ":doc:`QL language specification <ql-language-specification>`" and ":doc:`QLDoc comment specification <qldoc-comment-specification>`."
+For a formal specification of the QL language, see the ":doc:`QL language specification <ql-language-specification>`."
 
 QL and object orientation
 -------------------------

docs/codeql/ql-language-reference/index.rst

@@ -35,8 +35,6 @@ Learn all about QL, the powerful query language that underlies the code scanning
 
 - :doc:`QL language specification <ql-language-specification>`: A formal specification for the QL language. It provides a comprehensive reference for terminology, syntax, and other technical details about QL. 
 
-- :doc:`QLDoc comment specification <qldoc-comment-specification>`: A formal specification for QLDoc comments.
-
 .. toctree::
    :maxdepth: 1
    :hidden:
@@ -56,4 +54,3 @@ Learn all about QL, the powerful query language that underlies the code scanning
    name-resolution
    evaluation-of-ql-programs
    ql-language-specification
-   qldoc-comment-specification

docs/codeql/ql-language-reference/lexical-syntax.rst

@@ -16,12 +16,10 @@ For an overview of the lexical syntax, see "`Lexical syntax
 Comments
 ********
 
-All standard one-line and multiline comments, as described in the "`QL language specification 
-<ql-language-specification#comments>`_," are ignored by the QL 
+All standard one-line and multiline comments are ignored by the QL 
 compiler and are only visible in the source code.
 You can also write another kind of comment, namely **QLDoc comments**. These comments describe
-QL entities and are displayed as pop-up information in QL editors. For information about QLDoc
-comments, see the ":doc:`QLDoc comment specification <qldoc-comment-specification>`."
+QL entities and are displayed as pop-up information in QL editors.
 
 The following example uses these three different kinds of comments: