From f1521944ede8caf0a9fafd8bf1504ea6038d19cd Mon Sep 17 00:00:00 2001 From: Ivailo Monev Date: Fri, 29 Mar 2024 10:15:33 +0200 Subject: [PATCH] kio: documentation updates Signed-off-by: Ivailo Monev --- kio/kio/job_p.h | 2 +- kio/kio/kprotocolmanager.h | 7 +++---- kio/kio/slavebase.h | 3 +-- 3 files changed, 5 insertions(+), 7 deletions(-) diff --git a/kio/kio/job_p.h b/kio/kio/job_p.h index 65278f5e..bd01f6f4 100644 --- a/kio/kio/job_p.h +++ b/kio/kio/job_p.h @@ -127,7 +127,7 @@ namespace KIO { // (2) The actual protocol that the io-slave uses. // // These two often match, but not necessarily. Most notably, they don't - // match when doing ftp via a proxy. + // match when a slave is used for more than one protocol (e.g. curl). // In that case (1) is ftp, but (2) is http. // // JobData::protocol stores (2) while Job::url().protocol() returns (1). diff --git a/kio/kio/kprotocolmanager.h b/kio/kio/kprotocolmanager.h index 7a709d7a..f3c81e3b 100644 --- a/kio/kio/kprotocolmanager.h +++ b/kio/kio/kprotocolmanager.h @@ -40,12 +40,11 @@ namespace KIO * Provides information about I/O (Internet, etc.) settings chosen/set by the end user. * * KProtocolManager has a heap of static functions that allows only read access to KDE's IO related - * settings. These include proxy, file transfer resumption, timeout and user-agent related - * settings. + * settings. These file transfer resumption, timeout and user-agent related settings. * * The information provided by this class is generic enough to be applicable to any application - * that makes use of KDE's IO sub-system. Note that this mean the proxy, timeout etc. settings - * are saved in a separate user-specific config file and not in the config file of the application. + * that makes use of KDE's IO sub-system. Note that this mean the timeout etc. settings are saved + * in a separate user-specific config file and not in the config file of the application. * * Original author: * @author Torben Weis diff --git a/kio/kio/slavebase.h b/kio/kio/slavebase.h index be2fd009..7dddb26f 100644 --- a/kio/kio/slavebase.h +++ b/kio/kio/slavebase.h @@ -483,7 +483,6 @@ public: /** * Used for any command that is specific to this slave (protocol) - * Examples are : HTTP POST, mount and unmount (kio_file) * * @param data packed data; the meaning is completely dependent on the * slave, but usually starts with an int for the command number. @@ -493,7 +492,7 @@ public: /** * Called by the scheduler to tell the slave that the configuration - * changed (i.e. proxy settings) . + * changed (i.e. timeout settings) . */ virtual void reparseConfiguration();