summaryrefslogtreecommitdiffstats
path: root/src/libs/installer/lib7z_facade.cpp
diff options
context:
space:
mode:
authorArttu Tarkiainen <arttu.tarkiainen@qt.io>2020-09-16 18:14:44 +0300
committerArttu Tarkiainen <arttu.tarkiainen@qt.io>2020-09-21 06:44:32 +0000
commit17f3e4fb3a2e560131527f91ca64944667223bd9 (patch)
tree483eb0e64b5cf4adcab969bedaa88dba3d2b83ce /src/libs/installer/lib7z_facade.cpp
parent7b16ab246d5c8241f08c0ffa3a87c9803ec4aa50 (diff)
Doc: Reduce the amount of documentation warnings
Miscellaneous fixes to missing function documentation, undocumented parameters, namespace scope etc. As 5.12.7 based qdoc gives a lot more warnings about code missing documentation, mark undocumented implementation details with \internal command. Also some spelling fixes to related parts of documentation. Task-number: QTIFW-1483 Change-Id: Ibf5d1e5098713acbd152c5b61ea4f46cc11feb4b Reviewed-by: Katja Marttila <katja.marttila@qt.io>
Diffstat (limited to 'src/libs/installer/lib7z_facade.cpp')
-rw-r--r--src/libs/installer/lib7z_facade.cpp12
1 files changed, 6 insertions, 6 deletions
diff --git a/src/libs/installer/lib7z_facade.cpp b/src/libs/installer/lib7z_facade.cpp
index c321052e3..3e6b10259 100644
--- a/src/libs/installer/lib7z_facade.cpp
+++ b/src/libs/installer/lib7z_facade.cpp
@@ -832,7 +832,7 @@ STDMETHODIMP ExtractCallback::SetOperationResult(Int32 /*resultEOperationResult*
/*!
\fn virtual Lib7z::ExtractCallback::setCompleted(quint64 completed, quint64 total)
- Returns completed. Always returns true. \a completed and \a total are unused.
+ Always returns \c true. \c completed and \c total are unused.
*/
@@ -951,9 +951,9 @@ static QString createTmp7z()
}
/*!
- Creates an archive using the given file device \a archive. \a sourcePaths can contain one or
- more files, one or more directories or a combination of files and folders. The \c * wildcard
- is supported also. The value of \a level specifies the compression ratio, the default is set
+ Creates an archive using the given file device \a archive. \a sources can contain one or
+ more files, one or more directories or a combination of files and folders. Also, \c * wildcard
+ is supported. The value of \a level specifies the compression ratio, the default is set
to \c 5 (Normal compression). The \a callback can be used to get information about the archive
creation process. If no \a callback is given, an empty implementation is used.
@@ -979,8 +979,8 @@ void INSTALLER_EXPORT createArchive(QFileDevice *archive, const QStringList &sou
}
/*!
- Creates an archive with the given filename \a archive. \a sourcePaths can contain one or more
- files, one or more directories or a combination of files and folders. Also the \c * wildcard
+ Creates an archive with the given filename \a archive. \a sources can contain one or more
+ files, one or more directories or a combination of files and folders. Also, \c * wildcard
is supported. To be able to use the function during an elevated installation, set \a mode to
\c TmpFile::Yes. The value of \a level specifies the compression ratio, the default is set
to \c 5 (Normal compression). The \a callback can be used to get information about the archive