Die Borland InterBase 6 Beta docs - obwohl kostenlos - sind nicht Bestandteil des InterBase-Pakets, das im Juli 2000 Open-Source wurde. Wir haben mehrmals bei Borland angefragt, ob wir diese Dokumente nutzen könnten,„ da sie unter die InterBase Public License fielen“, aber sie haben sich nicht mal die Mühe gemacht zu antworten. Fühlen Sie sich frei, diese Dokumentation als Informationsquellen zu verwenden, aber kopieren Sie keine Texte hieraus.

PostgreSQL ist eine weitere wichtige Open-Source-Datenbank, mit (nicht überraschend) vielen Ähnlichkeiten zu Firebird, es gibt aber auch viele Unterschiede. Abhängig von der Art der Dokumentation, die Sie schreiben wollen, kann es vorteilhaft sein, sich auf bestehende PostgreSQL-Dokumente zu stützen. Beachten Sie aber, dass, wenn Sie PostgreSQL Material verwenden, MÜSSEN Sie deren Copyright in Ihrem Dokument verwenden!

Die Homepage der PostgreSQL-Dokumentationen ist hier:

Die aktuelle PostgreSQL-Lizenz finden Sie hier:

Eine nette Sache der PostgreSQL-Dokus ist, dass sie ebenfalls in DocBook verfasst sind, genau wie unsere. Allerdings verwenden sie DocBook SGML anstelle von XML, somit werden bestimmte Einstellungen erforderlich sein. Die DocBook SGML Quellen finden Sie hier:

Oder schauen Sie sich den gesamten CVS-Baum, Dokus und alles weitere an. Für weitere Anweisungen schauen Sie unter:

Um Ihre Arbeit unter der PDL freizugeben, fügen Sie ein appendix mit dem Titel License Notice und folgendem Text an:

Alles, was wie _LIKE THIS_ aussieht, muss natürlich ersetzt werden. Wenn Sie nicht der ursprüngliche Autor sind, lassen Sie seine oder ihre Bekanntmachung intakt und fügen Sie den folgenden Text ein:

Es kann diverse Contributor's sections (Hinweise auf Beitragende Autoren) in den Lizenzhinweisen geben.

Wenn Ihr Beitrag aus mehr als einer einfachen Änderung oder Addition an einer Stelle besteht, fügen Sie einen Anhang ( appendix ) mit Namen Dokumenthistorie vor oder nach der Lizenz und Datenschutz ein. Wenn ein solcher Anhang bereits vorhanden ist, geben Sie eine immer eine Beschreibung Ihrer Modifikation(en) darin an. Bitte beachten Sie, dass selbst wenn es bereits eine Dokumenthistorie gibt, Sie noch einen Mitwirkendenabschnitt in den Lizenzhinweisen hinzufügen müssen - aber Sie können dann auch einen Hinweis „siehe Dokumenthistorie“ anstelle der Kurzbeschreibung angeben.

Wenn Sie der ursprüngliche Autor sind, dann ist es auch völlig in Ordnung, eine Dokumenthistorie in der ersten Version eines Dokuments für spätere Revisionen einzufügen. Vergleichen Sie das erste Revision-Element im Beispiel unten.

Gegenstand der Dokumenthistorie ist das Element revhistory mit seinen Unterelementen:

<revhistory>
  <revision>
    <revnumber>1.0</revnumber>
    <date>12 Sep 2005</date>
    <authorinitials>PV</authorinitials>
    <revdescription>
      <para>First version</para>
    </revdescription>
  </revision>
  <revision>
    <revnumber>1.1</revnumber>
    <date>5 Dec 2005</date>
    <authorinitials>PV</authorinitials>
    <revdescription>
      <para>Added information on COALESCE</para>
      <para>Corrected some spelling errors</para>
    </revdescription>
  </revision>
</revhistory>

Bitte kürzen Sie die Monatsnamen im Date-Element, da die Datumsspalte im PDF recht schmal ist.

Unten ist ein Beispiel zur Dokumenthistorie (Ausgabeansicht, nicht Quelle!), welches ein revhistory-Element darstellt. Beachten Sie die Verweise im CVS-Baum: Wir sind gesetzlich verpflichtet, alle Änderungen zu identifizieren und zu datieren. Aber da CVS dies bereits tut, können wir einfach den Benutzer hierüber informieren und eine weniger umfangreiche, aber schöner zu lesende Historie im Dokument selbst vorzeigen.

Wenn Sie den DocBook-Quellcode dieses Leitfadens in Ihrem XML-Editor öffnen (src/docs/firebirddocs/docwriting-howto.xml), können Sie ganz einfach die Dokumenthistorie und die Lizenzhinweise kopieren und in ihr eigenes Dokument einfügen. Kopieren Sie nicht die oben angeführten Beispiele; kopieren Sie die realen Anlagen am Ende der Dokumente, und bearbeiten Sie diese.

Unsere Lizenz und Documenthistorie, erscheinen beide am Ende des Dokument. Wenn Ihre Urheberrechte offensichtlich direkt am Beginn ausweisen möchten, können Sie auch einen kurzen Copyright-Hinweis in der xxxinfo des Dokuments einfügen, so z.B.:

<bookinfo>
  <title...
  <author...
  <edition...
  <copyright>
    <year>2003</year>
    <year>2004</year>
    <holder>Tootsie Griff</holder>
  </copyright>
</bookinfo>

Solch ein Hinweis ersetzt nicht die Lizenzhinweise und / oder Dokumenthistorie - es ist ein Extra.

Anstelle der URL, können Sie auch die gesamte PDL in Ihrem Dokument anhängen. Dies kann besonders nützlich sein, wenn Ihre Arbeit ein Buch (book) oder langer Artikel (article) ist und Sie erwarten (oder hoffen), dass die Menschen es drucken und in Papierform verteilen werden. Auf einem kurzen Dokument wird die gesamte PDL ein wenig übertrieben wirken, aber es ist Ihre Entscheidung.

Sie können die PDL DocBook-Quellen unter src/docs/firebirddocs/licenses.xml erhalten. Bitte beachten Sie, dass nur der Abschnitt mit dem Lizenztext selbst (einschließlich der allgemeine Lizenzhinweis) zur PDL gehört. Die Einführung ist nicht Bestandteil der Lizenz.

Wenn Sie die PDL in Ihrem Dokument einbinden, können Sie die Leerstellen in Abschnitt 5.2 der Lizenz ausfüllen. Sie können sie aber auch lassen, wie sie sind (vorausgesetzt, Ihr Name steht im Lizenzhinweis) oder geben Sie einfach den „Initial Writer“ oder „den Urheberrechtshalter“ an.

Die Übersetzung eines Dokuments ist eine Art der Bearbeitung. Wenn Sie also ein Übersetzer sind, sollten Sie folgende Dinge tun:

Sie müssen die PDL nicht üebersetzen. Wenn Sie dies jedoch tun:

Optional können Sie die übersetzte PDL an Ihr Dokument anhängen, wenn Sie der Extraaufwand nicht stört.