diff options
Diffstat (limited to 'src/qdoc/puredocparser.cpp')
-rw-r--r-- | src/qdoc/puredocparser.cpp | 128 |
1 files changed, 0 insertions, 128 deletions
diff --git a/src/qdoc/puredocparser.cpp b/src/qdoc/puredocparser.cpp deleted file mode 100644 index 1c8baf37d..000000000 --- a/src/qdoc/puredocparser.cpp +++ /dev/null @@ -1,128 +0,0 @@ -/**************************************************************************** -** -** Copyright (C) 2020 The Qt Company Ltd. -** Contact: https://www.qt.io/licensing/ -** -** This file is part of the tools applications of the Qt Toolkit. -** -** $QT_BEGIN_LICENSE:GPL-EXCEPT$ -** Commercial License Usage -** Licensees holding valid commercial Qt licenses may use this file in -** accordance with the commercial license agreement provided with the -** Software or, alternatively, in accordance with the terms contained in -** a written agreement between you and The Qt Company. For licensing terms -** and conditions see https://www.qt.io/terms-conditions. For further -** information use the contact form at https://www.qt.io/contact-us. -** -** GNU General Public License Usage -** Alternatively, this file may be used under the terms of the GNU -** General Public License version 3 as published by the Free Software -** Foundation with exceptions as appearing in the file LICENSE.GPL3-EXCEPT -** included in the packaging of this file. Please review the following -** information to ensure the GNU General Public License requirements will -** be met: https://www.gnu.org/licenses/gpl-3.0.html. -** -** $QT_END_LICENSE$ -** -****************************************************************************/ - -#include "puredocparser.h" - -#include "qdocdatabase.h" -#include "tokenizer.h" - -#include <cerrno> - -QT_BEGIN_NAMESPACE - -/*! - Returns a list of the kinds of files that the pure doc - parser is meant to parse. The elements of the list are - file suffixes. - */ -QStringList PureDocParser::sourceFileNameFilter() -{ - return QStringList() << "*.qdoc" - << "*.qtx" - << "*.qtt" - << "*.js"; -} - -/*! - Parses the source file identified by \a filePath and adds its - parsed contents to the database. The \a location is used for - reporting errors. - */ -void PureDocParser::parseSourceFile(const Location &location, const QString &filePath) -{ - QFile in(filePath); - currentFile_ = filePath; - if (!in.open(QIODevice::ReadOnly)) { - location.error(QStringLiteral("Can't open source file '%1' (%2)") - .arg(filePath) - .arg(strerror(errno))); - currentFile_.clear(); - return; - } - - Location fileLocation(filePath); - Tokenizer fileTokenizer(fileLocation, in); - m_tokenizer = &fileTokenizer; - m_token = m_tokenizer->getToken(); - - /* - The set of open namespaces is cleared before parsing - each source file. The word "source" here means cpp file. - */ - qdb_->clearOpenNamespaces(); - - processQdocComments(); - in.close(); - currentFile_.clear(); -} - -/*! - This is called by parseSourceFile() to do the actual parsing - and tree building. It only processes qdoc comments. It skips - everything else. - */ -bool PureDocParser::processQdocComments() -{ - const QSet<QString> &commands = topicCommands() + metaCommands(); - - while (m_token != Tok_Eoi) { - if (m_token == Tok_Doc) { - QString comment = m_tokenizer->lexeme(); // returns an entire qdoc comment. - Location start_loc(m_tokenizer->location()); - m_token = m_tokenizer->getToken(); - - Doc::trimCStyleComment(start_loc, comment); - Location end_loc(m_tokenizer->location()); - - // Doc constructor parses the comment. - Doc doc(start_loc, end_loc, comment, commands, topicCommands()); - const TopicList &topics = doc.topicsUsed(); - if (topics.isEmpty()) { - doc.location().warning(QStringLiteral("This qdoc comment contains no topic command " - "(e.g., '\\%1', '\\%2').") - .arg(COMMAND_MODULE) - .arg(COMMAND_PAGE)); - continue; - } - if (hasTooManyTopics(doc)) - continue; - - DocList docs; - NodeList nodes; - QString topic = topics[0].topic; - - processTopicArgs(doc, topic, nodes, docs); - processMetaCommands(nodes, docs); - } else { - m_token = m_tokenizer->getToken(); - } - } - return true; -} - -QT_END_NAMESPACE |