Swiftdiff options
| author | Tobias Markmann <tm@ayena.de> | 2015-10-27 16:53:17 (GMT) |
|---|---|---|
| committer | Kevin Smith <kevin.smith@isode.com> | 2015-10-30 12:44:47 (GMT) |
| commit | 1d921f3d39ed134ca7f1d40011c1a07a5835b73c (patch) | |
| tree | 1bd90c302d1641f452ed397f930e92bd736c6b09 | |
| parent | 0f5ef716a50c8d9761cafda12aacf818cdfd6353 (diff) | |
| download | swift-1d921f3d39ed134ca7f1d40011c1a07a5835b73c.zip swift-1d921f3d39ed134ca7f1d40011c1a07a5835b73c.tar.bz2 | |
Fix Doxygen issues
Ran ./scons doc=1 with Doxygen 1.8.10 and fix all mentioned
errors.
Test-Information:
Tested building of documentation on OS X 10.10.1 with
Doxygen 1.8.10.
Change-Id: I136054f457f9b3ff6b269f5ac32bf435450c017c
| -rw-r--r-- | Documentation/API/Doxyfile | 9 | ||||
| -rw-r--r-- | Documentation/SwiftAPI/Doxyfile | 8 | ||||
| -rw-r--r-- | Swift/Controllers/ProfileSettingsProvider.h | 7 | ||||
| -rw-r--r-- | Swift/Controllers/Storages/FileStorages.h | 8 |
4 files changed, 10 insertions, 22 deletions
diff --git a/Documentation/API/Doxyfile b/Documentation/API/Doxyfile index dcc6286..84fdaac 100644 --- a/Documentation/API/Doxyfile +++ b/Documentation/API/Doxyfile @@ -62,13 +62,12 @@ GENERATE_TODOLIST = YES GENERATE_TESTLIST = YES GENERATE_BUGLIST = YES GENERATE_DEPRECATEDLIST= YES ENABLED_SECTIONS = MAX_INITIALIZER_LINES = 30 SHOW_USED_FILES = NO -SHOW_DIRECTORIES = NO SHOW_FILES = NO SHOW_NAMESPACES = NO FILE_VERSION_FILTER = #LAYOUT_FILE = #--------------------------------------------------------------------------- @@ -93,13 +92,12 @@ INPUT = \ Swiften/Client/CoreClient.h \ Swiften/Client/ClientError.h \ Swiften/Client/StanzaChannel.h \ Swiften/Client/NickResolver.h \ Swiften/Client/Storages.h \ Swiften/Client/MemoryStorages.h \ - Swiften/Client/FileStorages.h \ Swiften/Component/Component.h \ Swiften/Component/CoreComponent.h \ Swiften/Disco \ Swiften/Elements \ Swiften/EventLoop \ Swiften/JID \ @@ -151,13 +149,12 @@ IGNORE_PREFIX = GENERATE_HTML = YES HTML_OUTPUT = HTML_FILE_EXTENSION = .html HTML_HEADER = HTML_FOOTER = HTML_STYLESHEET = -HTML_ALIGN_MEMBERS = YES HTML_DYNAMIC_SECTIONS = YES GENERATE_DOCSET = YES DOCSET_FEEDNAME = "Swiften API Documentation" DOCSET_BUNDLE_ID = im.swift.Swiften GENERATE_HTMLHELP = YES CHM_FILE = @@ -170,13 +167,12 @@ TOC_EXPAND = NO #QCH_FILE = #QHP_NAMESPACE = im.swift.Swiften #QHP_VIRTUAL_FOLDER = doc #QHG_LOCATION = DISABLE_INDEX = NO ENUM_VALUES_PER_LINE = 4 -GENERATE_TREEVIEW = YES TREEVIEW_WIDTH = 250 FORMULA_FONTSIZE = 10 #--------------------------------------------------------------------------- # configuration options related to the LaTeX output #--------------------------------------------------------------------------- @@ -213,14 +209,12 @@ MAN_LINKS = NO #--------------------------------------------------------------------------- # configuration options related to the XML output #--------------------------------------------------------------------------- GENERATE_XML = NO XML_OUTPUT = xml -XML_SCHEMA = -XML_DTD = XML_PROGRAMLISTING = YES #--------------------------------------------------------------------------- # configuration options for the AutoGen Definitions output #--------------------------------------------------------------------------- GENERATE_AUTOGEN_DEF = NO @@ -259,13 +253,12 @@ PERL_PATH = /usr/bin/perl # Configuration options related to the dot tool #--------------------------------------------------------------------------- CLASS_DIAGRAMS = YES MSCGEN_PATH = HIDE_UNDOC_RELATIONS = YES HAVE_DOT = YES -DOT_FONTNAME = FreeSans DOT_FONTPATH = CLASS_GRAPH = YES COLLABORATION_GRAPH = YES GROUP_GRAPHS = YES UML_LOOK = NO TEMPLATE_RELATIONS = YES @@ -284,7 +277,7 @@ DOT_TRANSPARENT = NO DOT_MULTI_TARGETS = NO GENERATE_LEGEND = YES DOT_CLEANUP = YES #--------------------------------------------------------------------------- # Configuration::additions related to the search engine #--------------------------------------------------------------------------- -SEARCHENGINE = YES +SEARCHENGINE = NO diff --git a/Documentation/SwiftAPI/Doxyfile b/Documentation/SwiftAPI/Doxyfile index a4ada4a..f092c99 100644 --- a/Documentation/SwiftAPI/Doxyfile +++ b/Documentation/SwiftAPI/Doxyfile @@ -62,13 +62,12 @@ GENERATE_TODOLIST = YES GENERATE_TESTLIST = YES GENERATE_BUGLIST = YES GENERATE_DEPRECATEDLIST= YES ENABLED_SECTIONS = MAX_INITIALIZER_LINES = 30 SHOW_USED_FILES = NO -SHOW_DIRECTORIES = NO SHOW_FILES = NO SHOW_NAMESPACES = NO FILE_VERSION_FILTER = #LAYOUT_FILE = #--------------------------------------------------------------------------- @@ -152,13 +151,12 @@ IGNORE_PREFIX = GENERATE_HTML = YES HTML_OUTPUT = HTML_FILE_EXTENSION = .html HTML_HEADER = HTML_FOOTER = HTML_STYLESHEET = -HTML_ALIGN_MEMBERS = YES HTML_DYNAMIC_SECTIONS = YES GENERATE_DOCSET = YES DOCSET_FEEDNAME = "Swift XMPP Client Documentation" DOCSET_BUNDLE_ID = im.swift.Swiften GENERATE_HTMLHELP = YES CHM_FILE = @@ -171,13 +169,12 @@ TOC_EXPAND = NO #QCH_FILE = #QHP_NAMESPACE = im.swift.Swiften #QHP_VIRTUAL_FOLDER = doc #QHG_LOCATION = DISABLE_INDEX = NO ENUM_VALUES_PER_LINE = 4 -GENERATE_TREEVIEW = YES TREEVIEW_WIDTH = 250 FORMULA_FONTSIZE = 10 #--------------------------------------------------------------------------- # configuration options related to the LaTeX output #--------------------------------------------------------------------------- @@ -214,14 +211,12 @@ MAN_LINKS = NO #--------------------------------------------------------------------------- # configuration options related to the XML output #--------------------------------------------------------------------------- GENERATE_XML = NO XML_OUTPUT = xml -XML_SCHEMA = -XML_DTD = XML_PROGRAMLISTING = YES #--------------------------------------------------------------------------- # configuration options for the AutoGen Definitions output #--------------------------------------------------------------------------- GENERATE_AUTOGEN_DEF = NO @@ -260,13 +255,12 @@ PERL_PATH = /usr/bin/perl # Configuration options related to the dot tool #--------------------------------------------------------------------------- CLASS_DIAGRAMS = YES MSCGEN_PATH = HIDE_UNDOC_RELATIONS = YES HAVE_DOT = YES -DOT_FONTNAME = DOT_FONTPATH = CLASS_GRAPH = YES COLLABORATION_GRAPH = YES GROUP_GRAPHS = YES UML_LOOK = NO TEMPLATE_RELATIONS = YES @@ -285,7 +279,7 @@ DOT_TRANSPARENT = NO DOT_MULTI_TARGETS = NO GENERATE_LEGEND = YES DOT_CLEANUP = YES #--------------------------------------------------------------------------- # Configuration::additions related to the search engine #--------------------------------------------------------------------------- -SEARCHENGINE = YES +SEARCHENGINE = NO diff --git a/Swift/Controllers/ProfileSettingsProvider.h b/Swift/Controllers/ProfileSettingsProvider.h index 8bbc635..02e1e81 100644 --- a/Swift/Controllers/ProfileSettingsProvider.h +++ b/Swift/Controllers/ProfileSettingsProvider.h @@ -1,28 +1,29 @@ /* - * Copyright (c) 2010-2012 Isode Limited. + * Copyright (c) 2010-2015 Isode Limited. * All rights reserved. * See the COPYING file for more information. */ #pragma once -#include <Swift/Controllers/Settings/SettingsProvider.h> #include <Swiften/Base/foreach.h> +#include <Swift/Controllers/Settings/SettingsProvider.h> + namespace Swift { class ProfileSettingsProvider { public: ProfileSettingsProvider(const std::string& profile, SettingsProvider* provider); virtual ~ProfileSettingsProvider(); virtual std::string getStringSetting(const std::string &settingPath); virtual void storeString(const std::string &settingPath, const std::string &settingValue); virtual int getIntSetting(const std::string& settingPath, int defaultValue); virtual void storeInt(const std::string& settingPath, int settingValue); - /** See @SettingsProvider::getIsSettingFinal for discussion of what this means.*/ + /** See \ref SettingsProvider::getIsSettingFinal for discussion of what this means.*/ virtual bool getIsSettingFinal(const std::string& settingPath); private: std::string profileSettingPath(const std::string &settingPath); SettingsProvider* provider_; std::string profile_; diff --git a/Swift/Controllers/Storages/FileStorages.h b/Swift/Controllers/Storages/FileStorages.h index b498a15..195d0fa 100644 --- a/Swift/Controllers/Storages/FileStorages.h +++ b/Swift/Controllers/Storages/FileStorages.h @@ -1,8 +1,8 @@ /* - * Copyright (c) 2010-2013 Isode Limited. + * Copyright (c) 2010-2015 Isode Limited. * All rights reserved. * See the COPYING file for more information. */ #pragma once @@ -27,15 +27,15 @@ namespace Swift { /** * Creates the storages interface. * * All data will be stored relative to a base directory, and * for some controllers, in a subdirectory for the given profile. * The data is stored in the following places: - * - Avatars: <basedir>/avatars - * - VCards: <basedir>/<profile>/vcards - * - Entity capabilities: <basedir>/caps + * - Avatars: $basedir/avatars + * - VCards: $basedir/$profile/vcards + * - Entity capabilities: $basedir/caps * * \param baseDir the base dir to store data relative to * \param jid the subdir in which profile-specific data will be stored. * The bare JID will be used as the subdir name. */ FileStorages(const boost::filesystem::path& baseDir, const JID& jid, CryptoProvider*); |