Subversion Repositories SvarDOS

Package files provide an easy way to manage software on SvarDOS. These

Paketdateien bieten eine einfache Möglichkeit, Software unter SvarDOS zu

packages must adhere to a strict convention so they can be handled properly

verwalten. Diese Pakete müssen sich an eine strenge Konvention halten, damit

by the SvarDOS package manager.

sie vom SvarDOS-Paketmanager richtig behandelt werden können.

%hPackage filenames

%hDateinamen von Paketen

Packages names must follow some basic rules. They shall be max. 8 letters long

Buchstaben lang sein (sollten aber auch nicht zu kurz sein, da ein Paketname

(but should not be too short either, since a 1 or 2-letters package name might

mit 1 oder 2 Buchstaben verwirrend sein könnte) und dürfen nicht aus anderen

be confusing), and must not be composed of characters other than a-b, 0-9 and

Zeichen als a-b, 0-9 und '_' bestehen. Dies geschieht aus Gründen der

'_'. This for backward compatibility with short file names (8+3) and ISO 9660

Abwärtskompatibilität mit kurzen Dateinamen (8+3) und ISO 9660-Dateisystemen

file systems (used on CDROMs). The package filename is always followed by the

(auf CD-ROMs verwendet). Auf den Dateinamen des Pakets folgt immer die

.ZIP extension.

Erweiterung .ZIP.

%hPackage files

%hPaketdateien

SvarDOS uses ZIP files as its package file format. This format has been chosen

SvarDOS verwendet ZIP-Dateien als Paketdateiformat. Dieses Format wurde

because ZIP files under DOS have become the de facto way to distribute

gewählt, weil ZIP-Dateien unter DOS de facto zum Standardformat für die

collections of files. Also, the ZIP file format is well documented, well

Verteilung von Dateisammlungen geworden sind. Außerdem ist das ZIP-Dateiformat

supported, and in the public domain.

gut dokumentiert, wird gut unterstützt und ist Public Domain.

Here below is the recommended command line that can be used to create a

Nachfolgend finden Sie die empfohlene Befehlszeile, mit der Sie ein Paket für

package for a program named EXAMPLE using info-zip:

ein Programm namens BEISPIEL mit info-zip erstellen können:

  zip -9rkDX EXAMPLE.ZIP subdir1 subdir2 ... subdirN

  zip -9rkDX BEISPIEL.ZIP untverz1 untverz2 ... untverzN

If you are using 7za to create your packages, then use this:

Wenn Sie 7za verwenden, um Ihre Pakete zu erstellen, dann verwenden Sie dies:

  7za a -mm=deflate -mx=9 -tzip EXAMPLE.ZIP subdir1 subdir2 ... subdirN

  7za a -mm=deflate -mx=9 -tzip BEISPIEL.ZIP untverz1 untverz2 ... untverzN

%hPackage directory structure

%hVerzeichnisstruktur für Pakete

The directory structure of a package depends on the type of packages.

Die Verzeichnisstruktur eines Pakets hängt von der Art des Pakets ab.

For "core" packages, we have this:

Für Kernpakete haben wir dies:

  APPINFO            Put the program's LSM file here

  APPINFO            Legen Sie die LSM-Datei des Programms hier ab

  BIN                Binaries, such as exe and com files

  BIN                Binärdateien, wie z. B. exe- und com-Dateien

  DOC\PKGNAME        Package documentation

  DOC\PKGNAME        Dokumentation zum Paket

  HELP               Used ONLY by the "help" package

  HELP               Wird NUR vom Paket "help" verwendet

  NLS\PKGNAME        Localizations (NLS language files) of the package

  NLS\PKGNAME        Lokalisierungen (NLS-Sprachdateien) des Pakets

  SOURCE\PKGNAME     The source code (optional)

  SOURCE\PKGNAME     Der Quellcode (optional)

Non-core packages use a slightly different directory organization. For

Nicht-Kernpakete verwenden eine etwas andere Verzeichnisstruktur. Wenn wir

example, if we were to consider a package FOO, we might end up with the

zum Beispiel ein Paket FOO betrachten, könnten wir die folgende Struktur

following structure:

erhalten:

  APPINFO\FOO.LSM    Package meta file for the FOO program

  APPINFO\FOO.LSM    Paket-Metadatei für das Programm FOO

  PROGS\FOO\FOO.EXE  The program's executable

  PROGS\FOO\FOO.EXE  Die ausführbare Datei des Programms

  PROGS\FOO\FOO.TXT  Some documentation

  PROGS\FOO\FOO.TXT  Eine Dokumentation

  PROGS\FOO\FILE.DAT Data file used by the FOO program

  PROGS\FOO\FILE.DAT Vom Programm FOO verwendete Datendatei

  SOURCE\FOO\*       here would be stored the foo's source code (optional)

  SOURCE\FOO\*       Hier wird der Quellcode von foo gespeichert (optional)

Note the 'PROGS' directory above. This is a category to which the package

Beachten Sie das Verzeichnis PROGS oben. Dies ist die Kategorie, zu der das

belong. The package installer might change this directory at install time,

Paket gehört. Der Paketinstaller kann dieses Verzeichnis bei der Installation

depending on the user's preferences. Possible categories are listed below:

anpassen, je nach den Präferenzen des Benutzers. Mögliche Kategorien sind

Category | Description

Kategorie | Beschreibung

DEVEL    | Development tools (mostly compilers)

DEVEL     | Entwicklungswerkzeuge (hauptsächlich Compiler)

DRIVERS  | Drivers

DRIVERS   | Treiber

GAMES    | Games

GAMES     | Spiele

PROGS    | User programs, tools...

PROGS     | Anwendungen, Hilfsprogramme...

Note: "DOC", "NLS", "BIN" and "HELP" directories are strictly reserved to

Hinweis: Die Verzeichnisse "DOC", "NLS", "BIN" und "HELP" sind ausschließlich

      CORE packages.

         den Kernpaketen vorbehalten.

%hLSM meta-data files

%hLSM-Metadaten-Dateien

Every package MUST contain an LSM file in its "APPINFO" directory. This LSM

Jedes Paket MUSS eine LSM-Datei in seinem "APPINFO"-Verzeichnis enthalten.

file is a text file that contains basic information about the package. Its

Diese LSM-Datei ist eine Textdatei, die grundlegende Informationen über das

format is very simple, it must contain at least two lines:

Paket enthält. Ihr Format ist sehr einfach, sie muss mindestens zwei Zeilen

  description: package description

  description: Beschreibung des Pakets

Any other lines are ignored by the SvarDOS package manager.

Alle anderen Zeilen werden vom SvarDOS-Paketmanager ignoriert.

%hPackage versions

%hPaketversionen

The version present in the LSM file is meant to reflect the version of the

Die in der LSM-Datei enthaltene Version soll die Version der Software

packaged software, but it may happen that a package needs to be changed to

widerspiegeln, aber es kann vorkommen, dass ein Paket geändert werden muss, um

fix a strictly packaging-related issue (for example a forgotten documentation

Dokumentationsdatei oder eine Neukompilierung der Binärdatei unter Verwendung

file or a recompilation of the binary using a better set of flags...). In such

eines besseren Satzes von Flags...). In einem solchen Fall ändert sich die

case, the version of the software does not change, but the version of the

Version der Software nicht, aber die Version des Pakets selbst muss sich

package itself needs to change so users know something changed. That's where

ändern, damit die Benutzer wissen, dass sich etwas geändert hat. Das ist der

"SvarDOS revisions" come in. A version string is basically following such

Punkt, wo "SvarDOS-Revisionen" ins Spiel kommen. Eine Versionszeichenkette hat

format:

im Wesentlichen folgendes Format:

UPSTREAM_VER is the exact version string advertised by the software. It may

UPSTREAM_VER ist die genaue Versionsbezeichnung, die von der Software selbst

be pretty much anything. This upstream version may be optionally followed by a

angegeben wird. Sie kann so ziemlich alles sein. Dieser Upstream-Version kann

plus sign and the SvarDOS revision. In the event that the upstream version

optional ein Pluszeichen und die SvarDOS-Revision folgen. Falls die Upstream-

already contains a plus sign, then SvarDOS revision is delimited with a tilde.

Version bereits ein Pluszeichen enthält, wird die SvarDOS-Revision mit einer

The SvarDOS revision starts at 0 and increments each time that the given

Die SvarDOS-Revision beginnt bei 0 und wird jedes Mal um 1 erhöht, wenn die

upstream revision is repackaged. The SvarDOS revision restarts whenever the

gegebene Upstream-Revision neu paketiert wird. Die SvarDOS-Revision wird bei

upstream version changes. The SvarDOS revision of 0 is always hidden.

jeder Änderung der Upstream-Version neu gestartet. Die SvarDOS-Revision 0 ist

Examples:

Beispiele:

FDISK 1.54      <- originally packaged version

FDISK 1.54      <- ursprünglich paketierte Version

FDISK 1.54+1    <- package has been changed, but not the upstream version

FDISK 1.54+1    <- Paket wurde geändert, aber nicht die Upstream-Version

FDISK 1.55      <- upstream version increased, so SvarDOS rev restarts

FDISK 1.55      <- Upstream-Version erhöhte sich, so dass SvarDOS neu startet

FDISK 1.55+1    <- new version of the package, but still contains FDISK 1.55

FDISK 1.55+1    <- neue Version des Pakets, enthält aber immer noch FDISK 1.55

FDISK 1.55+2    <- another new version of the package, etc

FDISK 1.55+2    <- eine weitere neue Version des Pakets, usw.