Mailing-List: contact dev-help@corinthia.incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@corinthia.incubator.apache.org
Received-SPF: softfail (athena.apache.org: transitioning domain of
 dennis.hamilton@acm.org does not designate 216.234.124.51 as permitted
 sender)
Reply-To: <dennis.hamilton@acm.org>
From: "Dennis E. Hamilton" <dennis.hamilton@acm.org>
To: <dev@corinthia.incubator.apache.org>
References: <004a01d025f9$83b00620$8b101260$@acm.org>
 <CAK2iWdSROHJzNgs0T72kQkZ35iq4zxJRygGJHBn29Ti=q0WN3g@mail.gmail.com>
In-Reply-To: 
 <CAK2iWdSROHJzNgs0T72kQkZ35iq4zxJRygGJHBn29Ti=q0WN3g@mail.gmail.com>
Subject: RE: Defining the Stable Kernel
Date: Thu, 1 Jan 2015 15:32:27 -0800
Organization: NuovoDoc
Message-ID: <009f01d0261b$36505070$a2f0f150$@acm.org>
MIME-Version: 1.0
Content-Type: text/plain;
	charset="UTF-8"
Content-Transfer-Encoding: 7bit
Thread-Index: AQKp14zh+ZSg4UWwXEDZe9yNdyomxgMGWLPImuBGJGA=
Content-Language: en-us
Received-SPF: softfail (supercp.com: domain of transitioning
 dennis.hamilton@acm.org does not designate 97.113.57.118 as permitted sender)


 -- replying below to --
From: jan i [mailto:jani@apache.org] 
Sent: Thursday, January 1, 2015 13:23
To: dev@corinthia.incubator.apache.org; Dennis Hamilton
Subject: Re: Defining the Stable Kernel

[ ... ]

Let me tell how I see it:

If we start from the outside and dive into the project.

then the highest level is the consumers, they are applications that uses
the DocFormat library
below consumers we have the DocFormat library with a to be defined API ,
The library itself contains at top level of the different filters
(converters).
Each filter convert to/from our internal format (which there has been
discussion in here to change).

In order for filters not to (mis)use internal functions, the core should
provide a API (to be defined).

core + platform is the "kernel" which offers services to the filters and
DocFormat API.

<orcmid>
  OK, so exactly what is platform and what is core?  
  Is this specifically about the core/ and platform/ directories of the
  repository.  Does it include the api/ folder as well?

  I notice that platform/ has 3rdparty/ and also one src/ file each for
  Apple, Linux, Unix, Win32, and Wrapper.  So these get picked out 
  depending on what one is compiling for?
<orcmid>

Right now our consumer, filters make calls deep within core, and use all
structures directly. As long as peter did all the coding, that was a very
efficient way of doing it, but as we get more people on board, we need
abstraction layers. A core API + structures, is such an abstraction.

Hope that clarifies things a bit, but bear in mind you can see the
structure in visual studio, but at lot of the abstraction has not been
discussed yet and far less  implemented.

<orcmid>
  You lost me about seeing structure in "visual studio."
</orcmid>

rgds
jan i.