Updated some documentation based on a brief slack discussion with MG

This commit is contained in:
Klaus Basan
2016-10-29 00:32:01 +02:00
parent 0fd0ce05f0
commit c02cbcb952
3 changed files with 7 additions and 5 deletions

View File

@@ -31,6 +31,7 @@ namespace BlackCore
namespace Data
{
//! Global settings for readers, debug flags, etc.
//! \note also called the bootstrap file as it is needed once to get information where all the data are located
class BLACKCORE_EXPORT CGlobalSetup :
public BlackMisc::CValueObject<CGlobalSetup>,
public BlackMisc::ITimestampBased

View File

@@ -39,7 +39,7 @@ namespace BlackCore
m_cmdBootstrapUrl
{
{ "url", "bootstrapurl" },
QCoreApplication::translate("application", "bootstrap URL, e.g. datastore.swift-project.org"),
QCoreApplication::translate("application", "bootstrap URL, e.g. https://datastore.swift-project.org/shared"),
"bootstrapurl", (sApp->isUnitTest()) ? unitTestBootstrapUrl() : ""
}, m_cmdBootstrapMode
{
@@ -75,8 +75,8 @@ namespace BlackCore
CGlobalSetup cachedSetup = m_setup.get();
const bool cacheAvailable = cachedSetup.wasLoaded();
msgs.push_back(cacheAvailable ?
CStatusMessage(this, CStatusMessage::SeverityInfo , "Cached setup syncronized and contains data") :
CStatusMessage(this, CStatusMessage::SeverityInfo , "Cached setup syncronized, but no data")
CStatusMessage(this, CStatusMessage::SeverityInfo , "Cached setup synchronized and contains data") :
CStatusMessage(this, CStatusMessage::SeverityInfo , "Cached setup synchronized, but no data")
);
if (this->m_bootstrapMode == CacheOnly)
{

View File

@@ -30,7 +30,6 @@
class QNetworkReply;
namespace BlackMisc { class CLogCategoryList; }
namespace BlackCore
{
//! Read the central URLs / locations of our data / setup.
@@ -39,7 +38,9 @@ namespace BlackCore
//! update information.
//!
//! \note This class is no(!) BlackCore::CThreadedReader as it will be loaded once during startup
//! and reading setup data is fast.
//! and reading setup data is fast. The read file is also called "bootstrap" file as it tells
//! swift which data are located where. Without that file we cannot start. Once the file is in place (ie in the cache)
//! it can be automatically updated.
//!
//! \sa BlackCore::Data::TGlobalSetup
//! \sa BlackCore::Data::TUpdateInfo