*****************************************************************************
*                                                                           *
*                           »Library Guidelines«                            *
*                                                                           *
*****************************************************************************

                               1. Einleitung

Da wir im Moment sozusagen keine Firma haben die in der Lage ist eine
entsprechende Guideline vorzuschreiben bleibt nur, daß wir soetwas selbst
ins Leben rufen. In diesem Guide geht es um folgendes Problem:

           Die Namensgebung und Installation von Amiga Libraries.

Sollte doch nochmal irgendetwas mit dem Amiga passieren, wird dieses Dokument
an die entsprechende Firma übergeben.

Solange es noch keine entsprechende Firma gibt, übernehme ich
              Heiko Schröder - <age@thepentagon.com>
diese Aufgabe.


                        2. Library naming guidelines


- Der Name einer Library sollte möglichst sinnvoll und der Funktioninalität
  entsprechend gewählt werden, um Fehler oder Software-Abstürze zu vermeiden.

  Die Registration kann erfolgen über:

  WWW       : http://...      (noch nicht verfügbar)

  EMail     : Heiko Schröder - <age@thepentagon.com>
              Subject: Library registration

  Postweg   : Heiko Schröder
              Arnoldstr. 1
              04299 Leipzig
              GERMANY

         Bitte benutzen Sie das Registrationsformular.


- Applikation spezifische Libraries sollten bevorzugt aus dem Namen
  (oder Kürzel) der Applikation bestehen und einer Erweiterung die der
  Funktionalität der Library entspricht.


                        3. Installation von Libraries

- Libraries, die universell nutzbar sind und für die auch mindestens ein
  C-header file und die Autodocs verfügbar sind, dürfen in "Libs:" 
  installiert werden.
  Es ist ratsam, Libaries mit einem Interface für die folgenden Programmier-
  sprachen zu vertreiben:
   * C
   * Assembler
   * Amiga-E
   * Modula-II
   * Oberon

- Größere Library-Systeme wie z.B. MUI, XPK etc. sollten ein eigenes
  Directory haben (wie MUI) und dort ihre Libraries im MUI:Libs/ Verzeichnis
  installieren, die dann mittels 'assign add LIBS: MUI:Libs' in der
  "user-startup"-Datei im System verfügbar gemacht werden.

- Libraries die nur für ein bestimmtes Programm benutzt werden - d.h.
  private Libraries zu denen normal auch kein Include file und auch keine
  Autodocs öffentlich verfügbar sind gehören immer in "PROGDIR:Libs/"


                             4. Zusammenfassung

Library Autoren die sich nicht an dieses Guideline halten, werden

a) angeschrieben und entsprechend freundlich um Änderung/Abhilfe gebeten
b) 'offiziell' auf einer "schwarzen Liste" als illegal vermerkt
c) werden die Archive mit illegealen Libraries vom Aminet gelöscht -
   d.h. die Verbreitung dieser Libraries über die Haupt Amiga Vertriebskanäle
   (Aminet, Meeting Pearls, Fred Fish usw.) wird eingeschränkt.

*****************************************************************************

Verfaßt von

-------------------------------------------------------------------
Kai Hofmann             EMail: i07m@zfn.uni-bremen.de
FB 3, Informatik               i07m@informatik.uni-bremen.de
Universität Bremen      WWW  : http://www.informatik.uni-bremen.de/~i07m/
                        IRC  : PowerStat
-------------------------------------------------------------------

und

 ______________________________________
/                                      \
\         Heiko Schro"der (Age)        /
/                                      \
\        age@thepentagon.com           /
/                                      \
\  http://yi.com/home/SchroederHeiko   /
/______________________________________\