Changeset 21973 for trunk/doc


Ignore:
Timestamp:
Feb 21, 2012, 10:56:03 AM (14 years ago)
Author:
Silvan Scherrer
Message:

adjusted the readme

File:
1 edited

Legend:

Unmodified
Added
Removed

  • trunk/doc/Readme.txt

    r21921 r21973  
    1717
    1818This readme is intended for end users that have downloaded the
    19 latest public alpha release and want to give it a try. For more
     19latest public release and want to give it a try. For more
    2020information, be sure to regularly check http://svn.netlabs.org/odin32/.
    2121
    … …  
    3737------------------
    3838
    39 Odin is still in the early alpha state so that it is very far from
    40 being widely usable. Most programs will not work or show many
    41 problems. Even though it is not usable for most programs, we have
    42 decided to do a public release in order to show how much progress
    43 the project has been made. A second goal is to attract more developers
    44 in order to speedup development. Our job includes rewriting most
    45 parts of Windows 95/NT without having the original source code so
    46 the more developers we have the more progess will be seen. The
    47 last public release (Alpha 0.004) has been in 1997 and the project
    48 has changed much since then. Everything is free and Open Source now
    49 and the base architecture has been improved quite a lot. We are now
    50 in a position where we can expect the first bigger applications to
    51 run well and to make much more visible progress.
     39Odin is still in the early state so that it is very far from
     40being finished. With version 0.8 we reached the goal, that Flash 11
     41and OpenJDK6 runs.
    5242
    5343
    … …  
    6252-----------------------------
    6353
    64 Daily builds of Odin are available at ftp://ftp.netlabs.org/pub/odin/.
     54Builds of Odin are available at ftp://ftp.netlabs.org/pub/odin/.
    6555For people that do not have a suitable development setup for ODIN,
    6656we provide the latest binary code that way.
    6757
    68 Odin daily builds are now also distributed as WarpIn archives.
    69 WarpIn is a generic OS/2 installation application that can be
    70 downloaded from warpin.netlabs.org.
     58Odin builds are now also distributed as RPM packages beside the ZIP archives.
    7159
    7260Requirements for installing Odin:
    … …  
    7866    Warp 4 open32 dlls and patching them.
    7967- kLIBC runtime v0.6.4 (ftp://ftp.netlabs.org/pub/gcc/libc-0.6.4-csd4.zip).
    80 - GCC runtime v4.4.6
    81   (http://sourceforge.net/projects/ecsports/files/GCC%20Runtime%20DLLs/gcc446.zip).
     68- GCC runtime v4.4.6  (ftp://ftp.netlabs.org/pub/gcc/gcc4core-1_2_1.wpi).
     69For the latest requirements always see http://svn.netlabs.org/odin32
    8270
    8371In order to use system tray (notification/indicator area) support, you will
    … …  
    8573available at ftp://ftp.netlabs.org/pub/qt4/xsystray/ (version 0.1.1 and above).
    8674
    87 Manual installation without WarpIn is not recommended. If you don't use WarpIn,
     75Manual installation without RPM is not recommended. If you don't use RPM,
    8876then you *must* execute odininst.exe in the Odin system32 directory. (the first
    8977time Odin is installed or when the ChangeLog mentions fixes/changes in the
    … …  
    9381      HPFS/JFS). Odin will not work on FAT!
    9482
    95 To install Odin, run warpin.exe with the name of the daily build archive
    96 as parameter.
    97 Follow the instructions to complete the installation.
    98 The Odin installation consists of:
    99   - creating an Odin directory and copying the included files to
    100     x:\odin and x:\odin\system32
    101   - creating empty directories in x:\odin (to create a similar directory
    102     structure as found in Windows)
    103   - creating a basic registry for executing win32 applications in OS/2
    104   - adds x:\odin\system32 to the path and libpath settings in your config.sys
    105 
    106 NOTE: You MUST install Odin at least once using WarpIn (unless you know
    107       what you're doing). Afterwards you can use the daily build zipfiles
    108       to upgrade to a newer version.
     83To install Odin, run YUM install libodin
     84
     85If you don't like RPM the use the ZIP and do the following:
     86  - unzip Odin to a directory of your choice but preserve the structure in the ZIP
     87  - run odininst.exe from the x:\odin\system32 directory
     88  - add x:\odin\system32 to the path and libpath settings in your config.sys
    10989
    11090To run DirectDraw games or Quake 2 in Voodoo mode, you must install Holger
    … …  
    118982.0.1 Log files
    11999---------------
    120 The alpha 5 binaries and daily build zipfiles can generate logfiles to show
    121 what a win32 application is doing. This can be very useful to determine
    122 why certain applications don't run correctly.
     100The binaries can generate logfiles to show what a win32 application is doing.
     101This can be very useful to determine why certain applications don't run correctly.
    123102
    124103The major disadvantage of loggging is the overhead. Therefor it has been
    125 disabled by default in the alpha 5 release and daily builds.
     104disabled by default in the release builds.
    126105To enable logging set the environment variable WIN32LOG_ENABLED:
    127106   SET WIN32LOG_ENABLED=1
    … …  
    1851642.3 Win32k.sys - native OS/2 PE-loader
    186165--------------------------------------
     166
     167NOTE: This driver is not working anymore!! So the complete chapter 2.3 stays
     168      for historical reasons. If the driver will ever work again is not decided
     169      yet.
    187170
    188171The win32k.sys driver makes PE (Win32) executables equal to native OS/2
    … …  
    533516------------------------------------
    534517
    535 - Windows 95/NT Help Viewer (winhlp32.exe)
    536 - Windows 95/NT Registry Editor
    537 - Windows NT Solitaire (not the one from Windows 95)
    538 - Windows NT Freecell (not the one from Windows 95)
    539 - Windows 95/NT Calculator
    540 - Windows NT Pinball
    541 - Windows NT Minesweeper
    542 - Quake II
    543 - Red Alert
    544 - Professional Minesweeper
    545 - Windiff (part of Win32 SDK)
    546 - RealPlayer 7/8
    547 - Lotus Notes 5.0 (partly anyway)
    548 - Acrobat Distiller 3.0
     518- Flash 11
     519- OpenJDK6
    549520
    550521Note that many other applications load and/or partly work.
    … …  
    565536This chapter is intended for people more familiar with ODIN. It describes
    566537the various aspects of the project such as accessing the latest sources via
    567 cvs, building the binaries, running win32 applications, how to identify and
     538svn, building the binaries, running win32 applications, how to identify and
    568539report problems and bugs, as well as how to participate in this very
    569540promising project.
    … …  
    574545
    575546Required compilers/tools:
    576         - IBM VisualAge 3.0 (CTx8 fixpack applied)
    577           (version 3.6 might also work; version 4 is not recommended)
    578         - OS/2 Warp 4 Toolkit (project apparently doesn't compile with
    579           VAC's OS/2 headers)
    580           Might also work with EMX headers. (haven't tried this!)
    581         - ALP 4.0 (IBM Assembly Language Processor)
    582           Download the tools zipfile from http://service.boulder.ibm.com/ddk/
    583           (you need to register, but it's free)
    584         - Unix-like rm.exe (nmake clean)
     547        - GCC 4.4.6 (available as RPM)
     548        - OS/2 Toolkit 4.5
     549        - kBuild utility (available as RPM)
    585550
    586551Changes from last source code release:
    … …  
    590555        - All Open32 declarations are appended with '_O32' (mostly due to
    591556          calling convention differences)
    592         - nmake DEBUG=1 builds the debug version
    593           nmake         builds the release version
     557        - kmk BUILD_TYPE=debug builds the debug version
     558          kmk         builds the release version
    594559        - Several dlls (i.e. USER32, KERNEL32, ADVAPI32) contain extra .def
    595560          files that are used to create libraries that contain the api names
    … …  
    597562
    598563Wine header notes:
    599         - Several header files have been changed to make them usable for VAC
     564        - Several header files have been changed to make them usable for GCC
    600565        - Several header files contain bugfixes (mostly parameter type changes)
    601566        - Several header files include additional declarations
    … …  
    614579          compilation.
    615580          Use SendMessageA instead.
    616         - Source code style will be decided on in the near future.
    617 
    618 
    619 5.2.0 Accessing ODIN source code via CVS
     581
     582
     5835.2.0 Accessing ODIN source code via SVN
    620584----------------------------------------
    621585
    … …  
    626590---------------------------
    627591
    628 The first time you want to build Odin, you must first run configure.cmd.
    629 This REXX script creates the file makefile.inc, which contains the absolute
    630 paths of important build directories.
     592The first time you want to build Odin, you must copy the LocalConfig.kmk.tpl
     593to LocalConfig.kmk and adjust it to your environment.
    631594
    632595If your system setup meets above stated requirements, everything you
    633596need to do next for a binary build is:
    634597
    635   nmake DEBUG=1
     598  kmk BUILD_TYPE=debug
    636599
    637600or alternatively
    638601
    639   nmake release (not working right now!)
    640 
    641 As the current state of the project is still known to be alpha level, one should
     602  kmk
     603
     604As the current state of the project is still in early stage, one should
    642605expect some functions not to work properly. Therefore, we recommend the use of
    643606the debug-version which creates long logfiles for problem determination purpose
    … …  
    657620in the nodebuginfo build and not present in the release build.
    658621
     622
    6596235.3.1 Build problems
    660624--------------------
    … …  
    663627require you to do a full rebuild of the binaries instead of an incremental build.
    664628
    665 However, rarely it also happens the sources contained in the CVS repository do
     629However, rarely it also happens the sources contained in the SVN repository do
    666630not build completely due to erroneous source code. Usually, this is fixed within
    667631two days at maximum.
    … …  
    672636
    673637
    674 5.3.2 Downloading daily built binaries
    675 --------------------------------------
    676 
    677 http://www.os2.org/ has setup an ftp server that hosts the automatically
    678 built binaries on daily basis. For people that do not have a suitable
    679 development setup for ODIN, we provide the latest binary code that way.
     6385.3.2 Downloading daily binaries
     639--------------------------------
     640
     641We do not provide any daily binaries anymore.
    680642
    681643
    … …  
    688650examined problems.
    689651
    690 We suggest you subscribe to win32os2-wai and the corresponding mailing lists
    691 on http://www.egroups.com.
     652We suggest you subscribe to odin-user@netlabs.org.
    692653In case you are interested in participating, every member of the project will
    693654be happy to give you direction to the right places and to give a personal
Note: See TracChangeset for help on using the changeset viewer.