summaryrefslogtreecommitdiff
path: root/docs/src/opie-policy/core/core.sgml
Unidiff
Diffstat (limited to 'docs/src/opie-policy/core/core.sgml') (more/less context) (show whitespace changes)
-rw-r--r--docs/src/opie-policy/core/core.sgml39
1 files changed, 39 insertions, 0 deletions
diff --git a/docs/src/opie-policy/core/core.sgml b/docs/src/opie-policy/core/core.sgml
index 9db4de1..edd1075 100644
--- a/docs/src/opie-policy/core/core.sgml
+++ b/docs/src/opie-policy/core/core.sgml
@@ -1,30 +1,69 @@
1<chapter id="core"> 1<chapter id="core">
2 <title>Core Opie Policies</title> 2 <title>Core Opie Policies</title>
3 <sect1 id="imagepolicy"><title>Image Policy</title> 3 <sect1 id="imagepolicy"><title>Image Policy</title>
4 <para> 4 <para>
5 This section outlines policies with regard to images in Opie. Specifically, concerns regarding the structure of the pics/ subdirectory are addressed. 5 This section outlines policies with regard to images in Opie. Specifically, concerns regarding the structure of the pics/ subdirectory are addressed.
6 <itemizedlist><title>Primary Declarations</title> 6 <itemizedlist><title>Primary Declarations</title>
7 <listitem> 7 <listitem>
8 <para> 8 <para>
9 All generally <emphasis>useful</emphasis> images are to be inlined. 9 All generally <emphasis>useful</emphasis> images are to be inlined.
10 </para> 10 </para>
11 </listitem> 11 </listitem>
12 <listitem> 12 <listitem>
13 <para> 13 <para>
14 All images which are used by more than one Opie core application are to be inlined. 14 All images which are used by more than one Opie core application are to be inlined.
15 </para> 15 </para>
16 </listitem> 16 </listitem>
17 <listitem> 17 <listitem>
18 <para> 18 <para>
19 All images specific to one core application are to be moved into a pics/ subdirectory of the application's directory, and are to be packaged with the application. 19 All images specific to one core application are to be moved into a pics/ subdirectory of the application's directory, and are to be packaged with the application.
20 </para> 20 </para>
21 </listitem> 21 </listitem>
22 <listitem> 22 <listitem>
23 <para> 23 <para>
24 All other images are to be kept for compatibility reasons and are to be packaged in a opie-extrapics package. The opie-pics package will no longer exist, and no images will reside in the root of pics/. 24 All other images are to be kept for compatibility reasons and are to be packaged in a opie-extrapics package. The opie-pics package will no longer exist, and no images will reside in the root of pics/.
25 </para> 25 </para>
26 </listitem> 26 </listitem>
27 </itemizedlist> 27 </itemizedlist>
28 </para> 28 </para>
29 </sect1> 29 </sect1>
30 <sect1 id="librarypolicy"><title>Qtopia Compatibility</title>
31 <para>
32 This section outlines the stance of Opie with regard to compatibility with Qtopia. Testing must be done on a regular basis to ensure that this is still the case. Our applications must work in a Qtopia environment, and vice versa.
33 <itemizedlist><title>Primary Declarations</title>
34 <listitem>
35 <para>
36 Binary compatibility is to be retained with Qtopia, in both directions.
37 </para>
38 </listitem>
39 <listitem>
40 <para>
41 The libqpe library is not to be altered in such a way that compatibility is broken.
42 </para>
43 </listitem>
44 <listitem>
45 <para>
46 Functions may be added to the library, as long as that does not affect compatibility, and as long as said functions are used ONLY internally.
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Existing functions are not to be altered in an unexpected way.
52 </para>
53 </listitem>
54 </itemizedlist>
55 </para>
56 </sect1>
57 <sect1 id="corevsnoncore"><title>Core/NonCore</title>
58 <para>
59 This section outlines policies and guidelines with regard to the core/noncore seperation.
60 <itemizedlist><title>Primary Declarations</title>
61 <listitem>
62 <para>
63 NULL
64 </para>
65 </listitem>
66 </itemizedlist>
67 </para>
68 </sect1>
30</chapter> 69</chapter>