// Created: 09/17/99
// RCS-ID: $Id$
// Copyright: (c) David Webster
-// Licence: wxWindows license
+// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
// For compilers that support precompilation, includes "wx.h".
#include "wx/setup.h"
#include "wx/utils.h"
#include "wx/app.h"
- #include "wx/cursor.h"
#endif //WX_PRECOMP
#include "wx/os2/private.h"
-#include "wx/timer.h"
#include "wx/intl.h"
+#include "wx/apptrait.h"
#include <ctype.h>
-#include <direct.h>
+#ifdef __EMX__
+#include <dirent.h>
+#endif
#include "wx/log.h"
#include <errno.h>
#include <stdarg.h>
-#define INCL_DOS
-#define INCL_PM
-#define INCL_GPI
-#include <os2.h>
-#include<netdb.h>
#define PURE_32
+
+#ifndef __EMX__
#include <upm.h>
#include <netcons.h>
#include <netbios.h>
+#endif
-static const wxChar WX_SECTION[] = _T("wxWindows");
+static const wxChar WX_SECTION[] = _T("wxWidgets");
static const wxChar eHOSTNAME[] = _T("HostName");
static const wxChar eUSERID[] = _T("UserId");
static const wxChar eUSERNAME[] = _T("UserName");
#if wxUSE_NET_API
char zServer[256];
char zComputer[256];
- unsigned long ulLevel;
- unsigned char* zBuffer;
- unsigned long ulBuffer;
- unsigned long* pulTotalAvail;
+ unsigned long ulLevel = 0;
+ unsigned char* zBuffer = NULL;
+ unsigned long ulBuffer = 256;
+ unsigned long* pulTotalAvail = NULL;
NetBios32GetInfo( (const unsigned char*)zServer
,(const unsigned char*)zComputer
if ((zSysname = wxGetenv(_T("SYSTEM_NAME"))) == NULL)
{
- ULONG n = ::PrfQueryProfileString( HINI_PROFILE
- ,(PSZ)WX_SECTION
- ,(PSZ)eHOSTNAME
- ,(PSZ)zDefaultHost
- ,(void*)zBuf
- ,(ULONG)nMaxSize - 1
- );
+ ::PrfQueryProfileString( HINI_PROFILE
+ ,(PSZ)WX_SECTION
+ ,(PSZ)eHOSTNAME
+ ,(PSZ)zDefaultHost
+ ,(void*)zBuf
+ ,(ULONG)nMaxSize - 1
+ );
}
else
wxStrncpy(zBuf, zSysname, nMaxSize - 1);
// Get user ID e.g. jacs
bool wxGetUserId(
wxChar* zBuf
-, int nMaxSize
+, int nType
)
{
- return(U32ELOCL((unsigned char*)zBuf, (unsigned long *)&nMaxSize));
+#if defined(__VISAGECPP__)
+ long lrc;
+ // UPM procs return 0 on success
+ lrc = U32ELOCU((unsigned char*)zBuf, (unsigned long *)&nType);
+ if (lrc == 0) return TRUE;
+#endif
+ return FALSE;
}
bool wxGetUserName(
int wxKill(
long lPid
-, int nSig
+, wxSignal eSig
+, wxKillError* peError
)
{
return((int)::DosKillProcess(0, (PID)lPid));
const wxString& rCommand
)
{
- wxChar* zShell;
-
- if ((zShell = wxGetenv(_T("COMSPEC"))) == NULL)
- zShell = _T("\\CMD.EXE");
+ wxChar* zShell = _T("CMD.EXE");
+ wxString sInputs;
+ STARTDATA SData = {0};
+ PSZ PgmTitle = "Command Shell";
+ APIRET rc;
+ PID vPid = 0;
+ ULONG ulSessID = 0;
+ UCHAR achObjBuf[256] = {0}; //error data if DosStart fails
+ RESULTCODES vResult;
+
+ SData.Length = sizeof(STARTDATA);
+ SData.Related = SSF_RELATED_INDEPENDENT;
+ SData.FgBg = SSF_FGBG_FORE;
+ SData.TraceOpt = SSF_TRACEOPT_NONE;
+ SData.PgmTitle = PgmTitle;
+ SData.PgmName = zShell;
+
+ sInputs = "/C " + rCommand;
+ SData.PgmInputs = (BYTE*)sInputs.c_str();
+ SData.TermQ = 0;
+ SData.Environment = 0;
+ SData.InheritOpt = SSF_INHERTOPT_SHELL;
+ SData.SessionType = SSF_TYPE_WINDOWABLEVIO;
+ SData.IconFile = 0;
+ SData.PgmHandle = 0;
+ SData.PgmControl = SSF_CONTROL_VISIBLE | SSF_CONTROL_MAXIMIZE;
+ SData.InitXPos = 30;
+ SData.InitYPos = 40;
+ SData.InitXSize = 200;
+ SData.InitYSize = 140;
+ SData.Reserved = 0;
+ SData.ObjectBuffer = (char*)achObjBuf;
+ SData.ObjectBuffLen = (ULONG)sizeof(achObjBuf);
+
+ rc = ::DosStartSession(&SData, &ulSessID, &vPid);
+ if (rc == 0 || rc == 457) // NO_ERROR or SMG_START_IN_BACKGROUND
+ {
+ PTIB ptib;
+ PPIB ppib;
- wxChar zTmp[255];
+ ::DosGetInfoBlocks(&ptib, &ppib);
- if (rCommand != "")
- wxSprintf( zTmp
- ,"%s /c %s"
- ,zShell
- ,WXSTRINGCAST rCommand
- );
- else
- wxStrcpy(zTmp, zShell);
+ ::DosWaitChild( DCWA_PROCESS
+ ,DCWW_WAIT
+ ,&vResult
+ ,&ppib->pib_ulpid
+ ,vPid
+ );
+ }
+ return (rc != 0);
+}
- return (wxExecute((wxChar*)zTmp, FALSE) != 0);
+// Shutdown or reboot the PC
+bool wxShutdown(wxShutdownFlags wFlags)
+{
+ // TODO
+ return FALSE;
}
// Get free memory in bytes, or -1 if cannot determine amount (e.g. on UNIX)
-long wxGetFreeMemory(
- void* pMemptr
-)
+long wxGetFreeMemory()
{
+ void* pMemptr = NULL;
ULONG lSize;
ULONG lMemFlags;
APIRET rc;
return (long)lSize;
}
-// Sleep for nSecs seconds. Attempt a Windows implementation using timers.
-static bool inTimer = FALSE;
+// ----------------------------------------------------------------------------
+// env vars
+// ----------------------------------------------------------------------------
-class wxSleepTimer: public wxTimer
+bool wxGetEnv(const wxString& var, wxString *value)
{
-public:
- inline void Notify()
+ // wxGetenv is defined as getenv()
+ wxChar *p = wxGetenv(var);
+ if ( !p )
+ return FALSE;
+
+ if ( value )
{
- inTimer = FALSE;
- Stop();
+ *value = p;
}
-};
-static wxTimer* wxTheSleepTimer = NULL;
+ return TRUE;
+}
-void wxUsleep(
+bool wxSetEnv(const wxString& variable, const wxChar *value)
+{
+#if defined(HAVE_SETENV)
+ return setenv(variable.mb_str(), value ? wxString(value).mb_str().data()
+ : NULL, 1 /* overwrite */) == 0;
+#elif defined(HAVE_PUTENV)
+ wxString s = variable;
+ if ( value )
+ s << _T('=') << value;
+
+ // transform to ANSI
+ const char *p = s.mb_str();
+
+ // the string will be free()d by libc
+ char *buf = (char *)malloc(strlen(p) + 1);
+ strcpy(buf, p);
+
+ return putenv(buf) == 0;
+#else // no way to set an env var
+ return FALSE;
+#endif
+}
+
+void wxMilliSleep(
unsigned long ulMilliseconds
)
{
::DosSleep(ulMilliseconds);
}
+void wxMicroSleep(
+ unsigned long ulMicroseconds
+)
+{
+ ::DosSleep(ulMicroseconds/1000);
+}
+
void wxSleep(
int nSecs
)
// wxYield();
}
+#if WXWIN_COMPATIBILITY_2_2
+
// Output a debug mess., in a system dependent fashion.
void wxDebugMsg(
const wxChar* zFmt ...
, const wxString& rTitle
)
{
+ wxChar *wxBuffer = new wxChar[256];
wxSprintf(wxBuffer, "%s\nContinue?", WXSTRINGCAST rMsg);
if (::WinMessageBox( HWND_DESKTOP
,NULL
,0
,MB_ICONEXCLAMATION | MB_YESNO
) == MBID_YES)
+ delete[] wxBuffer;
wxExit();
}
DosExit(EXIT_PROCESS, ulRc);
}
+#endif // WXWIN_COMPATIBILITY_2_2
+
// Emit a beeeeeep
void wxBell()
{
DosBeep(1000,1000); // 1kHz during 1 sec.
}
-// Chris Breeze 27/5/98: revised WIN32 code to
-// detect WindowsNT correctly
-int wxGetOsVersion(
- int* pMajorVsn
-, int* pMinorVsn
-)
-{
- ULONG ulSysInfo[QSV_MAX] = {0};
-
- if (::DosQuerySysInfo( 1L
- ,QSV_MAX
- ,(PVOID)ulSysInfo
- ,sizeof(ULONG) * QSV_MAX
- ))
- {
- *pMajorVsn = ulSysInfo[QSV_VERSION_MAJOR];
- *pMinorVsn = ulSysInfo[QSV_VERSION_MINOR];
- return wxWINDOWS_OS2;
- }
- return wxWINDOWS; // error if we get here, return generic value
-}
-
-// Reading and writing resources (eg WIN.INI, .Xdefaults)
-#if wxUSE_RESOURCES
-bool wxWriteResource(
- const wxString& rSection
-, const wxString& rEntry
-, const wxString& rValue
-, const wxString& rFile
-)
-{
- HAB hab;
- HINI hIni;
-
- if (rFile != "")
- {
- hIni = ::PrfOpenProfile(hab, (PSZ)WXSTRINGCAST rFile);
- if (hIni != 0L)
- {
- return (::PrfWriteProfileString( hIni
- ,(PSZ)WXSTRINGCAST rSection
- ,(PSZ)WXSTRINGCAST rEntry
- ,(PSZ)WXSTRINGCAST rValue
- ));
- }
- }
- else
- return (::PrfWriteProfileString( HINI_PROFILE
- ,(PSZ)WXSTRINGCAST rSection
- ,(PSZ)WXSTRINGCAST rEntry
- ,(PSZ)WXSTRINGCAST rValue
- ));
- return FALSE;
-}
-
-bool wxWriteResource(
- const wxString& rSection
-, const wxString& rEntry
-, float fValue
-, const wxString& rFile
-)
-{
- wxChar zBuf[50];
-
- wxSprintf(zBuf, "%.4f", fValue);
- return wxWriteResource( rSection
- ,rEntry
- ,zBuf
- ,rFile
- );
-}
-bool wxWriteResource(const wxString& section, const wxString& entry, long value, const wxString& file)
+void wxAppTraits::InitializeGui(unsigned long &ulHab)
{
- wxChar buf[50];
- wxSprintf(buf, "%ld", value);
- return wxWriteResource(section, entry, buf, file);
}
-bool wxWriteResource(const wxString& section, const wxString& entry, int value, const wxString& file)
+void wxAppTraits::TerminateGui(unsigned long ulHab)
{
- wxChar buf[50];
- wxSprintf(buf, "%d", value);
- return wxWriteResource(section, entry, buf, file);
}
-bool wxGetResource(const wxString& section, const wxString& entry, wxChar **value, const wxString& file)
+wxToolkitInfo & wxConsoleAppTraits::GetToolkitInfo()
{
- HAB hab;
- HINI hIni;
- static const wxChar defunkt[] = _T("$$default");
-
- if (file != "")
- {
- hIni = ::PrfOpenProfile(hab, (PSZ)WXSTRINGCAST file);
- if (hIni != 0L)
- {
- ULONG n = ::PrfQueryProfileString( hIni
- ,(PSZ)WXSTRINGCAST section
- ,(PSZ)WXSTRINGCAST entry
- ,(PSZ)defunkt
- ,(void*)wxBuffer
- ,1000
- );
- if (n == 0L || wxStrcmp(wxBuffer, defunkt) == 0)
- return FALSE;
- }
- else
- return FALSE;
- }
- else
- {
- ULONG n = ::PrfQueryProfileString( HINI_PROFILE
- ,(PSZ)WXSTRINGCAST section
- ,(PSZ)WXSTRINGCAST entry
- ,(PSZ)defunkt
- ,(void*)wxBuffer
- ,1000
- );
- if (n == 0L || wxStrcmp(wxBuffer, defunkt) == 0)
- return FALSE;
- }
- if (*value)
- delete[] (*value);
- *value = copystring(wxBuffer);
- return TRUE;
-}
-
-bool wxGetResource(const wxString& section, const wxString& entry, float *value, const wxString& file)
-{
- wxChar *s = NULL;
- bool succ = wxGetResource(section, entry, (wxChar **)&s, file);
- if (succ)
- {
- *value = (float)wxStrtod(s, NULL);
- delete[] s;
- return TRUE;
- }
- else return FALSE;
-}
-
-bool wxGetResource(const wxString& section, const wxString& entry, long *value, const wxString& file)
-{
- wxChar *s = NULL;
- bool succ = wxGetResource(section, entry, (wxChar **)&s, file);
- if (succ)
- {
- *value = wxStrtol(s, NULL, 10);
- delete[] s;
- return TRUE;
- }
- else return FALSE;
-}
-
-bool wxGetResource(const wxString& section, const wxString& entry, int *value, const wxString& file)
-{
- wxChar *s = NULL;
- bool succ = wxGetResource(section, entry, (wxChar **)&s, file);
- if (succ)
- {
- *value = (int)wxStrtol(s, NULL, 10);
- delete[] s;
- return TRUE;
- }
- else return FALSE;
-}
-#endif // wxUSE_RESOURCES
-
-// ---------------------------------------------------------------------------
-// helper functions for showing a "busy" cursor
-// ---------------------------------------------------------------------------
-
-HCURSOR gs_wxBusyCursor = 0; // new, busy cursor
-HCURSOR gs_wxBusyCursorOld = 0; // old cursor
-static int gs_wxBusyCursorCount = 0;
-
-// Set the cursor to the busy cursor for all windows
-void wxBeginBusyCursor(wxCursor *cursor)
-{
- if ( gs_wxBusyCursorCount++ == 0 )
- {
- gs_wxBusyCursor = (HCURSOR)cursor->GetHCURSOR();
- ::WinSetPointer(HWND_DESKTOP, (HPOINTER)gs_wxBusyCursor);
- }
- //else: nothing to do, already set
-}
-
-// Restore cursor to normal
-void wxEndBusyCursor()
-{
- wxCHECK_RET( gs_wxBusyCursorCount > 0,
- _T("no matching wxBeginBusyCursor() for wxEndBusyCursor()"));
-
- if ( --gs_wxBusyCursorCount == 0 )
+ static wxToolkitInfo vInfo;
+ ULONG ulSysInfo[QSV_MAX] = {0};
+ APIRET ulrc;
+
+ vInfo.name = _T("wxBase");
+ ulrc = ::DosQuerySysInfo( 1L
+ ,QSV_MAX
+ ,(PVOID)ulSysInfo
+ ,sizeof(ULONG) * QSV_MAX
+ );
+ if (ulrc == 0L)
{
- ::WinSetPointer(HWND_DESKTOP, (HPOINTER)gs_wxBusyCursorOld);
- gs_wxBusyCursorOld = 0;
+ vInfo.versionMajor = ulSysInfo[QSV_VERSION_MAJOR] / 10;
+ vInfo.versionMinor = ulSysInfo[QSV_VERSION_MINOR];
}
-}
-
-// TRUE if we're between the above two calls
-bool wxIsBusy()
-{
- return (gs_wxBusyCursorCount > 0);
+ vInfo.os = wxOS2_PM;
+ return vInfo;
}
// ---------------------------------------------------------------------------
-const wxChar* wxGetHomeDir(wxString *pstr)
+const wxChar* wxGetHomeDir(
+ wxString* pStr
+)
{
- wxString& strDir = *pstr;
+ wxString& rStrDir = *pStr;
- // OS/2 has no idea about home,
- // so use the working directory instead?
+ // OS/2 has no idea about home,
+ // so use the working directory instead.
+ // However, we might have a valid HOME directory,
+ // as is used on many machines that have unix utilities
+ // on them, so we should use that, if available.
- // 256 was taken from os2def.h
+ // 256 was taken from os2def.h
#ifndef MAX_PATH
# define MAX_PATH 256
#endif
+ const wxChar *szHome = wxGetenv("HOME");
+ if ( szHome == NULL ) {
+ // we're homeless, use current directory.
+ rStrDir = wxT(".");
+ }
+ else
+ rStrDir = szHome;
- char DirName[256];
- ULONG DirLen;
-
- ::DosQueryCurrentDir( 0, DirName, &DirLen);
- strDir = DirName;
- return strDir.c_str();
+ return rStrDir.c_str();
}
// Hack for OS/2
-wxChar *wxGetUserHome (const wxString& user)
+wxChar* wxGetUserHome (
+ const wxString& rUser
+)
{
- wxChar *home;
- wxString user1(user);
-
- if (user1 != _T("")) {
- wxChar tmp[64];
- if (wxGetUserId(tmp, sizeof(tmp)/sizeof(char))) {
- // Guests belong in the temp dir
- if (wxStricmp(tmp, _T("annonymous")) == 0) {
- if ((home = wxGetenv(_T("TMP"))) != NULL ||
- (home = wxGetenv(_T("TMPDIR"))) != NULL ||
- (home = wxGetenv(_T("TEMP"))) != NULL)
- return *home ? home : (wxChar*)_T("\\");
- }
- if (wxStricmp(tmp, WXSTRINGCAST user1) == 0)
- user1 = _T("");
- }
- }
- if (user1 == _T(""))
- if ((home = wxGetenv(_T("HOME"))) != NULL)
- {
- wxStrcpy(wxBuffer, home);
- Unix2DosFilename(wxBuffer);
- return wxBuffer;
- }
- return NULL; // No home known!
-}
+ wxChar* zHome;
+ wxString sUser1(rUser);
-// Check whether this window wants to process messages, e.g. Stop button
-// in long calculations.
-bool wxCheckForInterrupt(wxWindow *wnd)
-{
- if(wnd){
- QMSG msg;
- HAB hab;
- HWND hwndFilter;
+ char *wxBuffer = new wxChar[256];
+#ifndef __EMX__
+ if (sUser1 != _T(""))
+ {
+ wxChar zTmp[64];
- HWND win= (HWND) wnd->GetHWND();
- while(::WinPeekMsg(hab,&msg,hwndFilter,0,0,PM_REMOVE))
+ if (wxGetUserId( zTmp
+ ,sizeof(zTmp)/sizeof(char)
+ ))
+ {
+ // Guests belong in the temp dir
+ if (wxStricmp(zTmp, _T("annonymous")) == 0)
+ {
+ if ((zHome = wxGetenv(_T("TMP"))) != NULL ||
+ (zHome = wxGetenv(_T("TMPDIR"))) != NULL ||
+ (zHome = wxGetenv(_T("TEMP"))) != NULL)
+ delete[] wxBuffer;
+ return *zHome ? zHome : (wxChar*)_T("\\");
+ }
+ if (wxStricmp(zTmp, WXSTRINGCAST sUser1) == 0)
+ sUser1 = _T("");
+ }
+ }
+#endif
+ if (sUser1 == _T(""))
{
- ::WinDispatchMsg( hab, &msg );
+ if ((zHome = wxGetenv(_T("HOME"))) != NULL)
+ {
+ wxStrcpy(wxBuffer, zHome);
+ wxUnix2DosFilename(wxBuffer);
+ wxStrcpy(zHome, wxBuffer);
+ delete[] wxBuffer;
+ return zHome;
+ }
}
- return TRUE;//*** temporary?
- }
- else{
- wxFAIL_MSG(_T("wnd==NULL !!!"));
-
- return FALSE;//*** temporary?
- }
+ delete[] wxBuffer;
+ return NULL; // No home known!
}
-void wxGetMousePosition( int* x, int* y )
-{
- POINTL pt;
- ::WinQueryPointerPos( HWND_DESKTOP, & pt );
- *x = pt.x;
- *y = pt.y;
-};
-
-// Return TRUE if we have a colour display
-bool wxColourDisplay()
+bool wxDirExists(
+ const wxString& rDir
+)
{
- bool flag;
- // TODO: use DosQueryDevCaps to figure it out
- return flag;
+ return (::DosSetCurrentDir(WXSTRINGCAST rDir));
}
-// Returns depth of screen
-int wxDisplayDepth()
+wxString WXDLLEXPORT wxPMErrorToStr(
+ ERRORID vError
+)
{
- HDC hDc = ::WinOpenWindowDC((HWND)NULL);
- long lArray[CAPS_COLOR_BITCOUNT];
- int nPlanes;
- int nBitsPerPixel;
- int nDepth;
-
- if(DevQueryCaps( hDc
- ,CAPS_FAMILY
- ,CAPS_COLOR_BITCOUNT
- ,lArray
- ))
- {
- nPlanes = (int)lArray[CAPS_COLOR_PLANES];
- nBitsPerPixel = (int)lArray[CAPS_COLOR_BITCOUNT];
- nDepth = nPlanes * nBitsPerPixel;
- }
- DevCloseDC(hDc);
- return (nDepth);
-}
+ wxString sError;
-// Get size of display
-void wxDisplaySize(int *width, int *height)
-{
- HDC hDc = ::WinOpenWindowDC((HWND)NULL);
- long lArray[CAPS_HEIGHT];
-
- if(DevQueryCaps( hDc
- ,CAPS_FAMILY
- ,CAPS_HEIGHT
- ,lArray
- ))
+ //
+ // Remove the high order byte -- it is useless
+ //
+ vError &= 0x0000ffff;
+ switch(vError)
{
- *width = (int)lArray[CAPS_WIDTH];
- *height = (int)lArray[CAPS_HEIGHT];
- }
- DevCloseDC(hDc);
-}
+ case PMERR_INVALID_HWND:
+ sError = wxT("Invalid window handle specified");
+ break;
-bool wxDirExists(const wxString& dir)
-{
- // TODO: Control program file stuff
- return TRUE;
-}
+ case PMERR_INVALID_FLAG:
+ sError = wxT("Invalid flag bit set");
+ break;
-// ---------------------------------------------------------------------------
-// window information functions
-// ---------------------------------------------------------------------------
+ case PMERR_NO_MSG_QUEUE:
+ sError = wxT("No message queue available");
+ break;
-wxString WXDLLEXPORT wxGetWindowText(WXHWND hWnd)
-{
- wxString str;
- long len = ::WinQueryWindowTextLength((HWND)hWnd) + 1;
- ::WinQueryWindowText((HWND)hWnd, len, str.GetWriteBuf((int)len));
- str.UngetWriteBuf();
+ case PMERR_INVALID_PARM:
+ sError = wxT("Parameter contained invalid data");
+ break;
- return str;
-}
+ case PMERR_INVALID_PARAMETERS:
+ sError = wxT("Parameter value is out of range");
+ break;
-wxString WXDLLEXPORT wxGetWindowClass(WXHWND hWnd)
-{
- wxString str;
+ case PMERR_PARAMETER_OUT_OF_RANGE:
+ sError = wxT("Parameter value is out of range");
+ break;
- int len = 256; // some starting value
+ case PMERR_INVALID_INTEGER_ATOM:
+ sError = wxT("Not a valid atom");
+ break;
- for ( ;; )
- {
- int count = ::WinQueryClassName((HWND)hWnd, len, str.GetWriteBuf(len));
+ case PMERR_INVALID_HATOMTBL:
+ sError = wxT("Atom table handle is invalid");
+ break;
- str.UngetWriteBuf();
- if ( count == len )
- {
- // the class name might have been truncated, retry with larger
- // buffer
- len *= 2;
- }
- else
- {
+ case PMERR_INVALID_ATOM_NAME:
+ sError = wxT("Not a valid atom name");
break;
- }
+
+ case PMERR_ATOM_NAME_NOT_FOUND:
+ sError = wxT("Valid name format, but cannot find name in atom table");
+ break;
+
+ default:
+ sError = wxT("Unknown error");
}
- return str;
-}
+ return(sError);
+} // end of wxPMErrorToStr
-WXWORD WXDLLEXPORT wxGetWindowId(WXHWND hWnd)
+// replacement for implementation in unix/utilsunx.cpp,
+// to be used by all X11 based ports.
+struct wxEndProcessData;
+
+void wxHandleProcessTermination(wxEndProcessData *proc_data)
{
- return ::WinQueryWindowUShort((HWND)hWnd, QWS_ID);
+ // For now, just do nothing. To be filled in as needed.
}
-