XWorkplace 1.0.16 README (C) Ulrich M”ller, Feb 7, 2000 Last updated 2018-12-26 0. CONTENTS OF THIS FILE ======================== 1. INTRODUCTION 2. REQUIREMENTS 3. INSTALLATION 4. UPGRADING 5. NATIONAL LANGUAGE SUPPORT 6. GETTING STARTED 7. LICENSE, COPYRIGHT, DISCLAIMER 8. CONTACT 1. INTRODUCTION =============== Welcome to XWorkplace V1.0.16. XWorkplace is a complex set of replacement classes for the OS/2 Workplace Shell to enhance the WPS's behavior in many ways. XWorkplace comes in two flavors: the classic XWP Full version with all features and endless configuration options, or the newer Lite version that's preconfigured with the best of XWP. Most ArcaOS and eComStation installations include customized versions of XWP Lite, known as "ArcaDesktop" and "eWorkplace". Contact the respective vendor for updates to those versions. This README has additional information which is not included in the XWorkplace User Guide. Please read through all of this before installing. After installation, you can find this README in the main install directory. About this release ------------------ This release from the SVN 1.0 branch includes all enhancements and bugfixes currently available. For details, refer to the "Version Notices" in the "XWorkplace User Guide". To extract the documentation only, see "3. INSTALLATION" below. 2. REQUIREMENTS =============== XWorkplace is currently developed and tested under ArcaOS but should work with any of these versions of OS/2: -- Warp 4 FP 15 -- WarpServer for e-Business -- Merlin/Aurora Convenience Packages -- eComStation v1.x / v2.x -- ArcaOS v5.x Features that rely on ACPI (e.g. power-off or CPU temperature) require the system to use a compatible version of 'ACPI.PSD'. 3. INSTALLATION =============== XWorkplace must be installed using WarpIN. After all files have been copied, WarpIN will restart your Workplace Shell to make sure the changes become active. A reboot should not be necessary. The .WPI archive is structured as 3 packages: the "XWP kernel", language-support files, and documentation. While you would normally install all 3, you can choose just documentation or only language-support if desired. Some WARNINGS: -- In any case, before installing, MAKE A WPS BACKUP. -- It was reported that the Workplace Shell hangs after a restart if you have "Automatic lockup on startup" enabled. If so, disable that setting before allowing WarpIN to restart the WPS. 4. UPGRADING ============ An upgrade requires the WarpIN installer to replace files that are currently in use. When it asks about locked files, be sure to select "Unlock (DosReplaceModule)". If it reports that 'xwpdaemn.exe' is running and must be killed, allow it to do so. Should you get prompted that a .HLP file is locked, opening and closing WPS help will unlock it: click on the Desktop then press F1. Warning: killing 'xwpdaemn.exe' has the unfortunate side-effect of making all your XWorkplace Startup Folders start if you accept WarpIN's offer to restart the desktop at the end of installation, even if they are set to start on reboots only. If this is a problem, decline the offer to restart the Desktop, and reboot manually after installation has completed. If upgrading doesn't work, have WarpIN remove the installed XWorkplace version first, restart the WPS, and then install the new version. Upgrading ArcaDesktop and eWorkplace ------------------------------------ You may want to contact your vendor for their customized upgrade before installing a generic version of XWorkplace. If you choose to proceed, you can install either XWP Lite to get a comparable set of features or XWP Full for all features. Be aware that the icons and titles of some XWP objects may change. 5. NATIONAL LANGUAGE SUPPORT ============================ Xworkplace (Full and Lite) is currently distributed in seven NLS versions: German, Dutch, Italian, Japanese, Spanish, Russian, and English. To change your installation's language, reinstall using the desired NLS version but only select the language-support package. If you've installed XWP Full, you can use its "XWorkplace Setup" object to select any of the installed languages. Note: additional NLS versions containing only language-support files may be available from 3rd-parties. 6. GETTING STARTED ================== XWorkplace Full users should open the "XWorkplace Setup" object first. Go to the "Features" page to explore and enable XWorkplace. XWorkplace Lite comes preconfigured with most features enabled. For both versions, most settings are integrated into WPS objects in the System Setup folder; additional options can also be found in the pages of the Desktop's Properties notebook. 7. LICENSE, COPYRIGHT, DISCLAIMER ================================= Copyright (C) 1997-2021 Ulrich M”ller, Martin Lafaix, Paul Ratcliffe, Rich Walsh, and others. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as contained in the file COPYING in the installation directory. The full source code is available. See XFLDR001.INF for details. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. For details, refer to the "Notices" section in XFLDR001.INF. 8. CONTACT ========== We have created two mailing lists at netlabs.org for contact. Please use these lists for general discussion about XWorkplace: For XWorkplace users: xworkplace-user@netlabs.org For XWorkplace developers and those who are interested: xworkplace-dev@netlabs.org For details, see "Notices" --> "Contact" in XFLDR001.INF. A bugtracker for XWorkplace is available at http://xtracker.netlabs.org Please use that beast for reporting bugs instead of posting them to the mailing lists. Thank you.