Changeset 52


Ignore:
Timestamp:
Aug 27, 2006, 2:34:20 PM (19 years ago)
Author:
ktk
Message:

Some updates for the book, first layout of chapters that seems to make sense.

Location:
DOV
Files:
5 edited
1 moved

Legend:

Unmodified
Added
Removed

  • DOV/TheDesignOfVoyager.xml

    r18 r52  
    11<?xml version='1.0'?>
    2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3b2/docbookx.dtd">
     2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD Simplified DocBook XML V1.0//EN" "http://www.oasis-open.org/docbook/xml/simple/1.0/sdocbook.dtd"
    33[
    4 <!ENTITY % vers   SYSTEM "version.xml">
    5 %vers;
    64<!ENTITY foreword SYSTEM "foreword.xml">
    75<!ENTITY ch00     SYSTEM "ch00.xml">
    … …  
    108<!ENTITY ch03     SYSTEM "ch03.xml">
    119<!ENTITY ch04     SYSTEM "ch04.xml">
     10<!ENTITY ch05     SYSTEM "ch05.xml">
    1211<!ENTITY appa     SYSTEM "appa.xml">
    13 <!ENTITY license  SYSTEM "copyright.xml">
    1412]>
    1513
    1614<book id="dov">
    1715        <title>The Design of Voyager</title>
    18 
    19   <bookinfo>
    20         <edition>First</edition>
    21     <copyright>
    22                 <year>2006</year>
    23                 <holder>netlabs.org</holder>
    24         </copyright>
    25          
    26           <authorgroup>
    27                   <author><firstname>Adrian</firstname><surname>Gschwend</surname></author>               
    28           </authorgroup>
    29          
    30     <legalnotice><para>This work is licensed under the Creative
    31       Commons Attribution License.  To view a copy of this license,
    32       visit <ulink url="http://creativecommons.org/licenses/by/2.0/"/>
    33       or send a letter to Creative Commons, 559 Nathan Abbott Way,
    34       Stanford, California 94305, USA.</para></legalnotice>       
    35          
    36 
    37   </bookinfo>
    3816       
    39   <!-- External entity refs -->
    40 
    41   &foreword;
    42   &ch00;
    43   &ch01;
    44   &ch02;
    45   &ch03;
    46   &ch04;
    47   &appa;
    48   &license;
     17        <bookinfo>
     18                <edition>First</edition>
     19                <copyright>
     20                        <year>2006</year>
     21                        <holder>netlabs.org</holder>
     22                </copyright>
     23               
     24                <authorgroup> <author>
     25                        <firstname>Adrian</firstname>
     26                        <surname>Gschwend</surname></author>
     27                </authorgroup>
     28               
     29                <legalnotice>
     30                        <para>This work is licensed under the Creative Commons Attribution License. To
     31                                view a copy of this license, visit <ulink
     32                                        url="http://creativecommons.org/licenses/by/2.0/"/> or send a
     33                                letter to Creative Commons, 559 Nathan Abbott Way, Stanford, California
     34                                94305, USA.</para>
     35                </legalnotice>
     36               
     37        </bookinfo>
    4938       
    50 
    51   <bibliography xmlns="http://docbook.org/ns/docbook">
    52 
    53     <title>References</title>
    54 
    55     <bibliodiv>
    56 
    57       <title>Books</title>
    58 
    59       <biblioentry>
    60 
    61         <abbrev>Kogan92</abbrev>
    62         <authorgroup>
    63 
    64           <author><personname><firstname>Mike</firstname><surname>Kogan</surname></personname></author>
    65 
    66           <author><personname><firstname>Harvey
    67           M.</firstname><surname>Deitel</surname></personname></author>
    68 
    69         </authorgroup>
    70 
    71         <copyright><year>1992</year></copyright>
    72         <biblioid class="isbn">0201548895</biblioid>
    73         <publisher><publishername>Addison-Wesley</publishername></publisher>
    74         <title>The Design of OS/2</title>
    75 
    76       </biblioentry>
    77 
    78     </bibliodiv>
    79 
    80   </bibliography>
    81 
     39        <!-- External entity refs -->
     40       
     41        &foreword;
     42        &ch00;
     43        &ch01;
     44        &ch02;
     45        &ch03;
     46        &ch04;
     47        &appa;
     48       
     49        <bibliography xmlns="http://docbook.org/ns/docbook">
     50               
     51                <title>References</title>
     52               
     53                <bibliodiv>
     54                       
     55                        <title>Books</title>
     56                       
     57                        <biblioentry>
     58                               
     59                                <abbrev>Kogan92</abbrev>
     60                                <authorgroup>
     61                                       
     62                                        <author>
     63                                                <personname>
     64                                                        <firstname>Mike</firstname>
     65                                                        <surname>Kogan</surname>
     66                                                </personname>
     67                                        </author>
     68                                       
     69                                        <author>
     70                                                <personname>
     71                                                        <firstname>Harvey M.</firstname>
     72                                                        <surname>Deitel</surname>
     73                                                </personname>
     74                                        </author>
     75                                       
     76                                </authorgroup>
     77                               
     78                                <copyright>
     79                                        <year>1992</year>
     80                                </copyright>
     81                                <biblioid class="isbn">0201548895</biblioid>
     82                                <publisher>
     83                                        <publishername>Addison-Wesley</publishername>
     84                                </publisher>
     85                                <title>The Design of OS/2</title>
     86                               
     87                        </biblioentry>
     88                       
     89                </bibliodiv>
     90               
     91        </bibliography>
     92       
    8293</book>
    8394

  • DOV/ch00.xml

    r17 r52  
     1<?xml version='1.0'?>
     2<!DOCTYPE preface PUBLIC "-//OASIS//DTD Simplified DocBook XML V1.0//EN" "http://www.oasis-open.org/docbook/xml/simple/1.0/sdocbook.dtd">
    13<preface>
    2         <title>Foreword</title>
    34       
    4         <para>For years a book called The Design of OS/2 was recommended by programmers as a
    5                 reference for everyone who wants to write an operating system. The book gave an
    6                 insight into the design of a modern operating system at the time but was still easy
    7                 to read also for not that experienced programmers.</para>
     5        <title>Preface</title>
     6        <simplesect>
     7               
     8                <blockquote>
     9                        <para><quote>I just called IBM software support: OS/2, this is an IBM product right?</quote>
     10                                &mdash;Achim calling IBM</para>
     11                </blockquote>
     12        </simplesect>
    813       
    9         <para>This document tries to provide the same for The Voyager Project, an attempt to
    10                 create an object oriented workplace for the 21th century. The ultimate goal is to
    11                 make it easy for new programmers to join the project. This book will give you a
    12                 starting point for that.</para>
     14        <section>
     15                <title>Audience</title>
     16                <para>Audience of the book</para>
     17        </section>
     18       
     19        <section>
     20                <title>Acknowledgments</title>
     21                <para>Blablabla</para>
     22        </section>
    1323       
    1424</preface>
     25

  • DOV/ch01.xml

    r17 r52  
    1   <chapter>
     1<?xml version='1.0'?>
     2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD Simplified DocBook XML V1.0//EN" "http://www.oasis-open.org/docbook/xml/simple/1.0/sdocbook.dtd">
     3<chapter>
    24
    3     <title>Voyager Components</title>
     5  <title>Motivation</title>
    46
    5     <para>bla</para>
     7  <section>
    68
    7   </chapter>
     9    <title>The Story so far</title>
     10
     11    <para>So far most attempts to <quote>save</quote> OS/2 were to come
     12    up with a group of people which started working on a kernel that
     13    has an OS/2 like API (<filename>DOS*</filename>, <filename>
     14    MOU*</filename>, <filename>VIO*</filename>, <filename>
     15    KBD*</filename>, ...). There are some fundamential missconcepts in
     16    this thinking:</para>
     17
     18    <itemizedlist>
     19
     20      <listitem>
     21
     22        <para>No user works with the kernel itself. The kernel is just
     23        there to provide abstractions to the hardware. Users work with
     24        applications and OS/2 users work a lot with the desktop as well
     25        (The <firstterm>WPS</firstterm>).</para>
     26
     27      </listitem>
     28
     29      <listitem>
     30
     31        <para>The OS/2 Kernel was ahead of its time in the early 90ies
     32        but meanwhile even Microsoft did their job and made the Windows
     33        kernel much more stable than it used to be. There are some
     34        things that are still great in the OS/2 kernel like a stable
     35        API, a working ABI and clearly separated parts which do not
     36        mess with each other. The OS/2 kernel is history nowadays, as
     37        porting to new hardware like 64bit processors is impossible to
     38        do.</para>
     39
     40      </listitem>
     41
     42      <listitem>
     43
     44        <para>Even if the OS/2 API was stable and great one day noone
     45        will code like this anymore nowadays. PM programming will scare
     46        away every student that grew up with Java or another high-level
     47        language like C++ and (RAD) toolkits like wxWidgets, qt and
     48        GTK2. The OS/2 PM API is definitely dead and a big
     49        <emphasis>don&apos;t</emphasis> for the future. There are
     50        enough alternatives which can provide what OS/2 programmers
     51        were used to work with (GPI/GDI for example).</para>
     52
     53      </listitem>
     54
     55      <listitem>
     56
     57        <para>The OS/2 community lost way too much time in porting
     58        drivers and software. Instead of focusing on real stuff like
     59        WPS integration most time spent on projects is stupid and
     60        boring porting work. This did not bring us further at all, just
     61        a few things were done the OS/2 way (like CDRecord).</para>
     62
     63      </listitem>
     64
     65    </itemizedlist>
     66
     67  </section>
     68
     69  <section>
     70
     71    <title>Conclusion</title>
     72
     73    <para>There are many things in OS/2 that are worth keeping but it
     74    wouldn&apos;t make sense to clone the current OS as a whole. The
     75    community could never do that and even if we could, it
     76    wouldn&apos;t solve the problems we suffer from nowadays.</para>
     77
     78    <para>A project like Voyager needs to focus on its main idea,
     79    everything that distracts from that goal should be reconsidered and
     80    if possible be replaced by something existing. We will explain in
     81    detail in the next chapters which core components need to be
     82    written by ourself and which components can be taken from other
     83    projects. We believe that this approach makes it possible to make
     84    Voyager a real peace of software instead of vapoware or a nice
     85    design study, as it is at the time writing.</para>
     86
     87  </section>
     88
     89  <para />
     90
     91  <para />
     92
     93  <para />
     94
     95</chapter>
     96

  • DOV/ch02.xml

    r17 r52  
    1   <chapter>
     1<?xml version='1.0'?>
     2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD Simplified DocBook XML V1.0//EN" "http://www.oasis-open.org/docbook/xml/simple/1.0/sdocbook.dtd">
     3<chapter>
     4
     5  <title>An Overview of Voyager</title>
     6
     7  <para>Basically a translation of the freeX Article.</para>
     8
     9  <section>
     10
     11    <title>The Voyager Project</title>
     12
     13    <para>Main overview</para>
     14
     15    <section>
     16
     17      <title>About the Codename</title>
     18
     19      <para><quote>The Voyager Project</quote> so far is just a
     20      codename.</para>
     21
     22    </section>
     23
     24  </section>
     25
     26  <section>
    227
    328    <title>Voyager Object Model</title>
    429
    5     <para>bla</para>
     30    <para>blabla</para>
    631
    7   </chapter>
     32  </section>
     33
     34  <section>
     35
     36    <title>Neptune</title>
     37
     38    <para>blabla</para>
     39
     40  </section>
     41
     42  <section>
     43
     44    <title>Kernel</title>
     45
     46    <para>blabla</para>
     47
     48  </section>
     49
     50  <section>
     51
     52    <title>License</title>
     53
     54    <para>blabla</para>
     55
     56    <para />
     57
     58  </section>
     59
     60  <para />
     61
     62</chapter>
     63

  • DOV/ch03.xml

    r17 r52  
    1   <chapter>
     1<?xml version='1.0'?>
     2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD Simplified DocBook XML V1.0//EN" "http://www.oasis-open.org/docbook/xml/simple/1.0/sdocbook.dtd">
     3<chapter>
    24
    3     <title>Triton</title>
     5  <title>Voyager Object Model</title>
    46
    5     <para>bla</para>
     7  <para>Copy the stuff from Cinc</para>
    68
    7   </chapter>
     9</chapter>
     10

  • DOV/ch05.xml

    r17 r52  
    1  <chapter>
     1<?xml version='1.0'?>
     2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD Simplified DocBook XML V1.0//EN" "http://www.oasis-open.org/docbook/xml/simple/1.0/sdocbook.dtd">
     3<chapter>
    24
    3     <title>Voyager Toolkit</title>
     5  <title>Coding on Voyager (Voyager Toolkit)</title>
    46
    5     <para>Header with data types for OS/2, information about glib
    6     etc</para>
     7  <para>Header with data types for OS/2, information about glib
     8  etc</para>
    79
    8   </chapter>
     10  <section>
     11
     12    <title>Documentation</title>
     13
     14    <para>An essential part for a project like Voyager is
     15    documentation. </para>
     16
     17  </section>
     18
     19  <section>
     20
     21    <title>Sample Code</title>
     22
     23    <para>Sample code</para>
     24
     25  </section>
     26
     27</chapter>
     28
Note: See TracChangeset for help on using the changeset viewer.