24.9.13

[Engine] * Remove all *LTRBA API functions. Use *LTWHA instead as the prior isn't meaningful anymore. * Clean-ups. [Assets] * Update refdoc to reflect API changes.
Mhatxotic · Sep 12, 2024 · b4bcae1 · b4bcae1
1 parent dff0c86
commit b4bcae1
Show file tree

Hide file tree

Showing 84 changed files with 376 additions and 574 deletions.
diff --git a/docs/index.html b/docs/index.html
diff --git a/src/archive.hpp b/src/archive.hpp
@@ -415,7 +415,7 @@ CTOR_MEM_BEGIN_ASYNC_CSLAVE(Archives, Archive, ICHelperUnsafe),
     cLog->LogInfoExSafe("Archive unloaded '$' successfully.", IdentGet());
   }
   /* ----------------------------------------------------------------------- */
-  DELETECOPYCTORS(Archive)             // Supress copy constructor for safety
+  DELETECOPYCTORS(Archive)             // Suppress default functions for safety
   /* -- Done with these defines -------------------------------------------- */
 #undef LZMAGetHandle                   // Done with this macro
 #undef LZMAOpen                        // Done with this macro

diff --git a/src/asset.hpp b/src/asset.hpp
@@ -221,7 +221,7 @@ CTOR_MEM_BEGIN_ASYNC_CSLAVE(Assets, Asset, ICHelperUnsafe),
   /* -- Destructor --------------------------------------------------------- */
   ~Asset(void) { AsyncCancel(); }
   /* ----------------------------------------------------------------------- */
-  DELETECOPYCTORS(Asset)               // Disable copy constructor and operator
+  DELETECOPYCTORS(Asset)               // Suppress default functions for safety
 };/* ======================================================================= */
 CTOR_END_ASYNC_NOFUNCS(Assets, Asset, ASSET, ASSET, bOverride(false));
 /* -- Class to help enumerate files ---------------------------------------- */

diff --git a/src/async.hpp b/src/async.hpp
@@ -617,7 +617,7 @@ template<class MemberType, class ColType>class AsyncLoader :
     AsyncStop();
   }
   /* ----------------------------------------------------------------------- */
-  DELETECOPYCTORS(AsyncLoader)         // Disable copy constructor
+  DELETECOPYCTORS(AsyncLoader)         // Suppress default functions for safety
 };/* -- Function to wait for async of all members in a collector ----------- */
 template<class MemberType,
          class LockType,
@@ -648,7 +648,7 @@ class CLHelperAsync :
     /* -- No code ---------------------------------------------------------- */
     { }
   /* ----------------------------------------------------------------------- */
-  DELETECOPYCTORS(CLHelperAsync)       // Supress copy constructor for safety
+  DELETECOPYCTORS(CLHelperAsync)       // Suppress default functions for safety
 };/* ----------------------------------------------------------------------- */
 }                                      // End of public module namespace
 /* ------------------------------------------------------------------------- */

diff --git a/src/audio.hpp b/src/audio.hpp
@@ -426,7 +426,7 @@ static class Audio final :             // Audio manager class
   /* -- Destructor --------------------------------------------------------- */
   DTORHELPER(~Audio, DeInit())         // Destructor helper
   /* ----------------------------------------------------------------------- */
-  DELETECOPYCTORS(Audio)               // Omit copy constructor for safety
+  DELETECOPYCTORS(Audio)               // Suppress default functions for safety
   /* ----------------------------------------------------------------------- */
   CVarReturn SetAudCheckRate(const unsigned int uiTime)
     { return CVarSimpleSetIntNLG(cdCheckRate,

diff --git a/src/cert.hpp b/src/cert.hpp
@@ -38,7 +38,7 @@ class Certs                            // Certificates store
     /* -- Destructor/Constructor ------------------------------------------- */
     LoadSerialised(void) { }           // Constructor not used
     /* --------------------------------------------------------------------- */
-    DELETECOPYCTORS(LoadSerialised)    // Disable copy constructor and operator
+    DELETECOPYCTORS(LoadSerialised)    // Suppress default functions for safety
   };/* -- Class to load certificates in parallel --------------------------- */
   class LoadParallel                   // Parallel certificate installation
   { /* --------------------------------------------------------------------- */
@@ -51,7 +51,7 @@ class Certs                            // Certificates store
     ~LoadParallel(void) { if(bLocked) UnlockFunction(); }
     LoadParallel(void) : bLocked(false) { }
     /* --------------------------------------------------------------------- */
-    DELETECOPYCTORS(LoadParallel)      // Disable copy constructor and operator
+    DELETECOPYCTORS(LoadParallel)      // Suppress default functions for safety
   };/* -- Variables -------------------------------------------------------- */
   SSL_CTX           *scStore;          // Context used for cerificate store
   X509_STORE        *xsCerts;          // Certificate store inside OpenSSL
@@ -303,7 +303,7 @@ class Certs                            // Certificates store
   /* -- Destructor that unloads all x509 certificates ---------------------- */
   ~Certs(void) { CertsEmpty(); }
   /* ----------------------------------------------------------------------- */
-  DELETECOPYCTORS(Certs)               // Disable copy constructor and operator
+  DELETECOPYCTORS(Certs)               // Suppress default functions for safety
   /* --------------------------------------------------------------- */ public:
   CVarReturn CertsSetBypassFlags1(const uint64_t uiFlags)
     { return CVarSimpleSetInt(qCertBypass.front(), uiFlags); }

diff --git a/src/cmdline.hpp b/src/cmdline.hpp
@@ -206,7 +206,7 @@ static struct CmdLine final            // Members initially public
   } // Parent process should be exiting cleanly after returning here
   DTORHELPEREND(~CmdLine)
   /* ----------------------------------------------------------------------- */
-  DELETECOPYCTORS(CmdLine)             // Remove default functions
+  DELETECOPYCTORS(CmdLine)             // Suppress default functions for safety
   /* -- End ---------------------------------------------------------------- */
 } *cCmdLine = nullptr;                 // Pointer to static class
 /* ------------------------------------------------------------------------- */

diff --git a/src/codec.hpp b/src/codec.hpp
@@ -470,7 +470,7 @@ class CoDecoder :                      // Magic decoder derivative class
       default: XC("Invalid version!", "Version", uiVersionActual);
     }
   } /* --------------------------------------------------------------------- */
-  DELETECOPYCTORS(CoDecoder)           // Omit copy constructor for safety
+  DELETECOPYCTORS(CoDecoder)           // Suppress default functions for safety
 };/* == Encoder base class ================================================= */
 template<class EncPlugin>class CoEncoder :
   /* -- Base classes ------------------------------------------------------- */
@@ -508,7 +508,7 @@ template<class EncPlugin>class CoEncoder :
     /* -- Code ------------------------------------------------------------- */
     { InitHeader(); }
   /* ----------------------------------------------------------------------- */
-  DELETECOPYCTORS(CoEncoder)           // Omit copy constructor for safety
+  DELETECOPYCTORS(CoEncoder)           // Suppress default functions for safety
 };/* ======================================================================= **
 ** ######################################################################### **
 ** ## Encoder helpers                                                     ## **
@@ -564,7 +564,7 @@ template<class EncoderType>class Block final : public EncoderType
     /* -- No code ---------------------------------------------------------- */
     { }
   /* ----------------------------------------------------------------------- */
-  DELETECOPYCTORS(Block)               // Omit copy constructor for safety
+  DELETECOPYCTORS(Block)               // Suppress default functions for safety
 };/* ----------------------------------------------------------------------- */
 }                                      // End of public module namespace
 /* ------------------------------------------------------------------------- */

diff --git a/src/collect.hpp b/src/collect.hpp
@@ -36,7 +36,7 @@ class LuaIdent {
     /* -- No code ---------------------------------------------------------- */
     { }
   /* ----------------------------------------------------------------------- */
-  DELETECOPYCTORS(LuaIdent)            // Don't need the copy constructor
+  DELETECOPYCTORS(LuaIdent)            // Suppress default functions for safety
 };/* -- Collector header --------------------------------------------------- */
 #define CTOR_HDR_BEGIN(p,              /* The parent (collector) class type */\
                        m,              /* The member class type             */\
@@ -58,7 +58,7 @@ class LuaIdent {
     public LuaIdent,                   /* Name of object for Lua            */\
     public hn                          /* Derived by our collector class    */\
     __VA_ARGS__                        /* Any other custom class derives    */\
-  { DELETECOPYCTORS(p)                 /* Remove default functions          */\
+  { DELETECOPYCTORS(p)                 /* Suppress copy constructor         */\
     p(void);                           /* Constructor prototype             */\
     ~p(void) noexcept(false);          /* Destructor prototype              */\
     x                                  /* Any extra variables? (no comma!)  */
@@ -200,7 +200,7 @@ class IHelper :                        // The Init Helper class
     /* -- No code ---------------------------------------------------------- */
     { }
   /* -- Default suppressions ----------------------------------------------- */
-  DELETECOPYCTORS(IHelper)             // Remove copy ctor/assign oper
+  DELETECOPYCTORS(IHelper)             // Suppress default functions for safety
 };/* ----------------------------------------------------------------------- */
 /* == Collector class helper =============================================== **
 ** ######################################################################### **
@@ -259,7 +259,7 @@ class CLHelperBase :
     /* -- No code ---------------------------------------------------------- */
     { }
   /* ----------------------------------------------------------------------- */
-  DELETECOPYCTORS(CLHelperBase)        // Don't need the copy constructor
+  DELETECOPYCTORS(CLHelperBase)        // Suppress default functions for safety
   /* -- Set limit ---------------------------------------------------------- */
   CVarReturn CLBaseSetLimitUnsafe(const size_t stLimit)
     { return CVarSimpleSetInt(stMaximum, stLimit); }
@@ -302,7 +302,7 @@ class CLHelperSafe :
   /* -- Destructor --------------------------------------------------------- */
   ~CLHelperSafe(void) { }
   /* ----------------------------------------------------------------------- */
-  DELETECOPYCTORS(CLHelperSafe)        // Don't need the copy constructor
+  DELETECOPYCTORS(CLHelperSafe)        // Suppress default functions for safety
   /* -- Return the mutex ------------------------------------------- */ public:
   mutex &CollectorGetMutex(void) { return *this; }
   /* -- Lock the mutex and return the removed iterator --------------------- */
@@ -338,7 +338,7 @@ class CLHelperUnsafe :                 // Members initially private
   /* -- Destructor --------------------------------------------------------- */
   ~CLHelperUnsafe(void) { }
   /* ----------------------------------------------------------------------- */
-  DELETECOPYCTORS(CLHelperUnsafe)      // Don't need the copy constructor
+  DELETECOPYCTORS(CLHelperUnsafe)      // Suppress default functions for safety
   /* -- Set maximum objects ------------------------------------------------ */
   CVarReturn CLSetLimit(const size_t stLimit)
     { return this->CLBaseSetLimitUnsafe(stLimit); }
@@ -382,7 +382,7 @@ struct CLHelper :                      // Members initially public
   /* -- Destructor --------------------------------------------------------- */
   ~CLHelper(void) { this->CLBaseCheckAndDestroyUnsafe(); }
   /* ----------------------------------------------------------------------- */
-  DELETECOPYCTORS(CLHelper)            // Don't need the copy constructor
+  DELETECOPYCTORS(CLHelper)            // Suppress default functions for safety
   /* -- Set maximum objects ------------------------------------------------ */
   CVarReturn CollectorSetLimit(const size_t stLimit)
     { return this->CLSetLimit(stLimit); }
@@ -471,7 +471,7 @@ struct ICHelperBase                    // Members initially public
   /* ----------------------------------------------------------------------- */
   ~ICHelperBase(void) { }
   /* ----------------------------------------------------------------------- */
-  DELETECOPYCTORS(ICHelperBase)        // Remove default functions
+  DELETECOPYCTORS(ICHelperBase)        // Suppress default functions for safety
 };/* ----------------------------------------------------------------------- */
 /* == Collector class helper WITH locks ==================================== **
 ** ######################################################################### **
@@ -511,7 +511,7 @@ class ICHelperSafe :                   // Members initially private
   explicit ICHelperSafe(CollectorType*const ctPtr, MemberType*const mtPtr) :
     BaseType(ctPtr, StdMove(ICHelperInit(ctPtr, mtPtr))) { }
   /* ----------------------------------------------------------------------- */
-  DELETECOPYCTORS(ICHelperSafe)        // Remove default functions
+  DELETECOPYCTORS(ICHelperSafe)        // Suppress default functions for safety
 };/* ----------------------------------------------------------------------- */
 /* == Collector class helper without locks ================================= **
 ** ######################################################################### **
@@ -551,7 +551,7 @@ class ICHelperUnsafe :                 // Members initially private
     /* -- No code ---------------------------------------------------------- */
     { }
   /* ----------------------------------------------------------------------- */
-  DELETECOPYCTORS(ICHelperUnsafe)      // Remove default functions
+  DELETECOPYCTORS(ICHelperUnsafe)      // Suppress default functions for safety
 };/* ----------------------------------------------------------------------- */
 /* == Collector class ====================================================== **
 ** ######################################################################### **
@@ -597,7 +597,7 @@ struct ICHelper :                      // Members initially public
     /* -- No code ---------------------------------------------------------- */
     { }
   /* ----------------------------------------------------------------------- */
-  DELETECOPYCTORS(ICHelper)            // Remove default functions
+  DELETECOPYCTORS(ICHelper)            // Suppress default functions for safety
 };/* ----------------------------------------------------------------------- */
 /* == Lua userdata helper ================================================== **
 ** ######################################################################### **
@@ -628,7 +628,7 @@ class Lockable                         // Members initially private
     /* -- No code ---------------------------------------------------------- */
     { }
   /* ----------------------------------------------------------------------- */
-  DELETECOPYCTORS(Lockable)            // Remove default functions
+  DELETECOPYCTORS(Lockable)            // Suppress default functions for safety
 };/* -- End ---------------------------------------------------------------- */
 };                                     // End of private module namespace
 /* ------------------------------------------------------------------------- */

diff --git a/src/congraph.hpp b/src/congraph.hpp
@@ -353,7 +353,7 @@ static class ConGraphics final :       // Members initially private
   /* -- Destructor --------------------------------------------------------- */
   DTORHELPER(~ConGraphics, DeInit())
   /* ----------------------------------------------------------------------- */
-  DELETECOPYCTORS(ConGraphics)         // Disable copy constructor and operator
+  DELETECOPYCTORS(ConGraphics)         // Suppress default functions for safety
   /* -- Set console background colour -------------------------------------- */
   CVarReturn TextBackgroundColourModified(const uint32_t ulNewColour)
     { return CVarSimpleSetInt(ulBgColour, ulNewColour); }

diff --git a/src/console.hpp b/src/console.hpp
@@ -904,7 +904,7 @@ static class Console final :           // Members initially private
   /* -- Destructor --------------------------------------------------------- */
   DTORHELPER(~Console, DeInit())
   /* ----------------------------------------------------------------------- */
-  DELETECOPYCTORS(Console)             // Disable copy constructor and operator
+  DELETECOPYCTORS(Console)             // Suppress default functions for safety
   /* -- Set page move count ------------------------------------------------ */
   CVarReturn SetPageMoveCount(const ssize_t sstAmount)
   { // Deny if invalid value

diff --git a/src/core.hpp b/src/core.hpp
@@ -885,7 +885,7 @@ class Core final :                     // Members initially private
   /* -- Destructor that clears the core pointer ---------------------------- */
   DTORHELPER(~Core, cCore = nullptr)
   /* ----------------------------------------------------------------------- */
-  DELETECOPYCTORS(Core)                // Disable copy constructor and operator
+  DELETECOPYCTORS(Core)                // Suppress default functions for safety
   /* -- Set lua error mode behaviour --------------------------------------- */
   CVarReturn CoreErrorBehaviourModified(const CoreErrorFlags cefNMode)
     { return CVarSimpleSetIntNGE(cefMode, cefNMode, CEF_MAX); }

diff --git a/src/crypt.hpp b/src/crypt.hpp
@@ -948,7 +948,7 @@ static class Crypt final :
   // Done
   DTORHELPEREND(~Crypt)
   /* -- Macros ---------------------------------------------------- */ private:
-  DELETECOPYCTORS(Crypt)               // Do not need defaults
+  DELETECOPYCTORS(Crypt)               // Suppress default functions for safety
   /* ----------------------------------------------------------------------- */
 } *cCrypt = nullptr;                   // Pointer to static class
 /* -- URL decode the specified string -------------------------------------- */

diff --git a/src/cvar.hpp b/src/cvar.hpp
@@ -518,7 +518,7 @@ class CVarItem :                       // Members initially private
     /* -- No code ---------------------------------------------------------- */
     { }
   /* -- Other -------------------------------------------------------------- */
-  DELETECOPYCTORS(CVarItem)            // No copy constructor
+  DELETECOPYCTORS(CVarItem)            // Suppress default functions for safety
 };/* ----------------------------------------------------------------------- */
 }                                      // End of public module namespace
 /* ------------------------------------------------------------------------- */

diff --git a/src/cvars.hpp b/src/cvars.hpp
@@ -735,7 +735,7 @@ static struct CVars final :            // Start of vars class
   /* -- Destructor --------------------------------------------------------- */
   DTORHELPER(~CVars, DeInit())         // Save and clean-up all variables
   /* ----------------------------------------------------------------------- */
-  DELETECOPYCTORS(CVars)               // Disable copy constructor and operator
+  DELETECOPYCTORS(CVars)               // Suppress default functions for safety
   /* ----------------------------------------------------------------------- */
   CVarReturn SetDefaults(const CVarDefaults cvdVal)
   { // Compare defaults setting