Changeset 475


Ignore:
Timestamp:
May 14, 2023, 5:47:12 PM (2 years ago)
Author:
ataylor
Message:

Update documentation for NewView 2.19.8.

Location:
trunk
Files:
2 edited

Legend:

Unmodified
Added
Removed
  • trunk/howto.txt

    r462 r475  
    44Copyright 2003-2006 Aaron Lawrence
    55Copyright 2006-2019 Ronald Brill
     6Copyright 2019-2023 Alex Taylor
    67
    78
    89The major parts of the code are developed in SpeedSoft Sibyl.
    910
    10 *Important Note*: This setup will use these updated Sibyl libraries instead 
     11*Important Note*: This setup will use these updated Sibyl libraries instead
    1112of the ones installed with Sibyl.  Aaron has made many bug fixes and a few
    1213enhancements.  Some things will not build with the original Sibyl Fixpack 3
    13 libraries, for example some components depend on parts of the SPCC being 
    14 changed from Private to Protected.  (There were apparently problems with 
     14libraries, for example some components depend on parts of the SPCC being
     15changed from Private to Protected.  (There were apparently problems with
    1516Sibyl Fixpack 4 and so it is not used, although some of the bug fixes from
    1617FP4 are included.)
     
    2627        hlpmgr          replacement for OS/2 HelpMgr.dll
    2728                        The HelpMgr DLL is compiled with Watcom C++.
    28                         It generates a DLL containing both 16 and 32 bit 
     29                        It generates a DLL containing both 16 and 32 bit
    2930                        entry points,like the original HelpMgr.dll.
    3031                        See http://www.openwatcom.org.
     
    6263   setup files.  To avoid committing working-copy-specific configuration to the
    6364   repository, templates are provided, along with a script to generate the
    64    working project files from them. 
     65   working project files from them.
    6566
    6667   From the top-level directory, run `project-setup.cmd`.  This will create
     
    7071   This can be done by copying each of the following files to the indicated
    7172   filename, and then replacing every instance of `@NV_DEV@` in the new files
    72    with the full path of your working copy's top level directory. 
     73   with the full path of your working copy's top level directory.
    7374
    7475        ae\ae.spr.def                    -->  ae\ae.spr
     
    100101
    101102
    102 Conventionally, I compile the libraries (Sibyl, Library, Components) with 
    103 debug information.  You can then turn debugging on or off when compiling 
     103Conventionally, I compile the libraries (Sibyl, Library, Components) with
     104debug information.  You can then turn debugging on or off when compiling
    104105NewView itself; if debugging is off, the library debug info will be discarded
    105106at link stage.
     
    115116
    116117The Components project (`Components\Components.spr`) contains the updated
    117 Sibyl controls used by NewView and other projects (including custom ones 
     118Sibyl controls used by NewView and other projects (including custom ones
    118119such as the rich text viewer).
    119120
    120 For the Sibyl IDE to be able to use these classes, they are compiled into 
     121For the Sibyl IDE to be able to use these classes, they are compiled into
    121122`CompLib.DLL`.  When building applications like NewView, however, the object
    122123files will be linked statically into the application.
    123124
    124125The `makeall.cmd` script in the `Components` directory will rebuild all the
    125 object files (and the test app, `Components.EXE`.  To rebuild `CompLib.DLL`, 
     126object files (and the test app, `Components.EXE`.  To rebuild `CompLib.DLL`,
    126127load `Components.spr` in the Sibyl IDE and rebuild it.
    127128
    128 *Note:* Because the IDE requires `CompLib.DLL` to actually load a project 
     129*Note:* Because the IDE requires `CompLib.DLL` to actually load a project
    129130using those classes, and the Components project includes a demo form with the
    130 classes on it, this rather unintuitively means that you can't build 
    131 `CompLib.DLL` unless a previously-built `CompLib.DLL` already exists.  For 
     131classes on it, this rather unintuitively means that you can't build
     132`CompLib.DLL` unless a previously-built `CompLib.DLL` already exists.  For
    132133this reason, a prebuilt version with all the new/modified classes is included
    133 in this repository. 
     134in this repository.
    134135
    135136
     
    144145
    145146To build a release version, you should build the executables from the GUI.
    146 When doing this, make sure that the directories `build\newview` and 
    147 `build\newview_stub` exist and are writable. 
     147When doing this, make sure that the directories `build\newview` and
     148`build\newview_stub` exist and are writable.
    148149
    149150To build NewView.EXE from the GUI, open the project file `NewView\NewView.spr`
    150 from the Sibyl IDE.  You should be able to build it from the Project menu. 
     151from the Sibyl IDE.  You should be able to build it from the Project menu.
    151152NewView.EXE will be placed in the `build\newview` directory.
    152153
     
    157158above for details.
    158159
    159 You can build ViewStub.EXE from the GUI in the same way as NewView.EXE, by 
     160You can build ViewStub.EXE from the GUI in the same way as NewView.EXE, by
    160161opening `NewView\ViewStub.spr` in the IDE and building it from the Project
    161162menu.  ViewStub.EXE will be placed in `build\newview_stub`.
     
    167168in the `build\hlpmgr` directory.
    168169
    169 Alternatively, if OpenWatcom is available in PATH, INCLUDE, and LIB, you can 
    170 run `wmake` directly.  However, note that the Watcom C makefile for HelpMgr 
    171 will build hlpmgr2.dll by default.  To build helpmgr.dll instead, build with 
     170Alternatively, if OpenWatcom is available in PATH, INCLUDE, and LIB, you can
     171run `wmake` directly.  However, note that the Watcom C makefile for HelpMgr
     172will build hlpmgr2.dll by default.  To build helpmgr.dll instead, build with
    172173`wmake helpmgr.dll` (which `makeall.cmd` does).
    173174
    174 helpmgr.dll is normally in use by the WPS (WorkPlace Shell, the desktop) so to 
    175 put it into use, you must either use a DLL-unlocking utility like replmod (on 
    176 Hobbes.nmsu.edu) or boot to a command prompt, and replace the dll in 
     175helpmgr.dll is normally in use by the WPS (WorkPlace Shell, the desktop) so to
     176put it into use, you must either use a DLL-unlocking utility like replmod (on
     177Hobbes.nmsu.edu) or boot to a command prompt, and replace the dll in
    177178`c:\os2\dll`.
    178179
     
    184185### NewView DLL ###
    185186
    186 Go to the `newview_dll` directory and run `makeall.cmd`.  Or, if OpenWatcom 
    187 and PMPrintF are already installed and available in PATH, INCLUDE, and LIB, 
     187Go to the `newview_dll` directory and run `makeall.cmd`.  Or, if OpenWatcom
     188and PMPrintF are already installed and available in PATH, INCLUDE, and LIB,
    188189you can simply run `wmake` directly.
    189190
     
    191192### Help & Language Files ###
    192193
    193 The NewView help file was is in .ipf format and can be compiled with the 
     194The NewView help file was is in .ipf format and can be compiled with the
    194195OS/2 IPFC compiler.  The language files use Aaron's language support module
    195196(see `NewView\Design.txt` for technical information) and are simply structured
     
    197198
    198199Run `makeall.cmd` from the `i18n` directory to build/copy all the help and
    199 language files.  Each language lives in a subdirectory with its own 
     200language files.  Each language lives in a subdirectory with its own
    200201`makeall.cmd` that gets called by the parent script.
    201202
     
    206207is the old standalone installer for NewView.  The project will create the
    207208executable NewViewInstall.EXE - you are recommended to rename it to install.exe
    208 if you need distribute it as part of a NewView installation ZIP file. 
     209if you need distribute it as part of a NewView installation ZIP file.
     210
     211Make sure steps 1-3 above have been completed.
     212
     213Also make sure the directory `build\installer` exists and is writable.
    209214
    210215The install executable requires Aaron's renmodul.dll, a copy of which is in the
     
    225230    install.exe         (from build\installer)
    226231    renmodul.dll             (from installer)
    227     gpl.txt                     (from newview)
     232    gpl.txt                     (from i18n)
     233    Changes.txt                 (from i18n)
     234    readme.txt                  (from i18n)
    228235    (language files)            (from build\newview_i18n)
    229236
     
    242249Make sure steps 1-3 above have been completed.
    243250
    244 Also make sure the directory `build\ConfigApps` exists. 
     251Also make sure the directory `build\ConfigApps` exists.
    245252
    246253Open the project file `ConfigApps\ConfigApps.spr` in the Sibyl IDE.  You should
    247 be able to build it from the Project menu.  ConfigApps.EXE will be placed in 
     254be able to build it from the Project menu.  ConfigApps.EXE will be placed in
    248255the `build\ConfigApps` directory.
    249256
     
    254261Make sure steps 1-3 above have been completed.
    255262
    256 Also make sure the directory `build\AE` exists. 
    257 
    258 Open the project file `ae\ae.spr` in the Sibyl IDE.  You should be able to build 
     263Also make sure the directory `build\AE` exists.
     264
     265Open the project file `ae\ae.spr` in the Sibyl IDE.  You should be able to build
    259266it from the Project menu.  AE.EXE will be placed in the `build\AE` directory.
    260267
     
    269276They should not be needed anymore, but are included for posterity.
    270277
    271 -- 
     278--
    272279
    2732802. Unzip all files.
  • trunk/i18n/Changes.txt

    r442 r475  
    11NewView release changes
     2
     3V2.19.8
     4- Fix: Controls and dialogs should now scale more reliably when using large fonts.
     5- Tweak: The Application Font setting, if not set explicitly, defaults to the global
     6   Presentation Manager window text font.
     7- Tweak: Updated contact info links on product info dialog.
    28
    39V2.19.7
Note: See TracChangeset for help on using the changeset viewer.