source: trunk/README.de @ 14068

Last change on this file since 14068 was 12092, checked in by jmpp, 15 years ago

Submitted by: jmpp@

Small change in documentation URL to give more relevance to the DP site.
I'm thinking, however, about the relevance of these files now that we are
distributing a 1.0 tarball that doesn't include them...

  • Property svn:eol-style set to native
File size: 5.2 KB
Line 
1WAS IST DAS DARWIN PORTS SYSTEM
2
3    DarwinPorts ist eine Infrastruktur zum Kompilieren, Installieren und
4    Paketisieren von Software, entwickelt, um die gleiche Funktionalitaet wie
5    das FreeBSD Ports-System zu bieten und gleichzeitig erweiterbar zu bleiben.
6
7    DarwinPorts laeuft zur Zeit auf MacOS X 10.2 (Darwin 6.0) und MacOS X 10.3, ist
8        aber auf Portierbarkeit ausgelegt. Implementiert ist DarwinPorts in TCL mit einigen
9    TCL-Erweiterungen, die in C geschrieben sind.
10
11        Der "DarwinPorts User Guide" ist online verfuegbar unter der Adresse:
12        http://darwinports.opendarwin.org/docs
13
14    In base/doc/INTERNALS ist eine detaillierte Beschreibung der Architektur
15    zu finden.
16
17    DarwinPorts ist in zwei Bestandteile aufgeteilt. Die "DarwinPorts Infrastruktur",
18    die im Unterverzeichniss base/ liegt, und das "dports/"-Verzeichniss, welches
19    die Metadaten zu der verfuegbaren, portierten Software enthaelt.
20
21INSTALLATION
22
23        Die Datei base/doc/README.platforms enthaelt plattform-spezifische Hinweise zur
24        Installation von DarwinPorts auf nicht Darwin-basierten Betriebsystemen.
25
26    Installations-Schritte:
27   
28        1. cd base/
29           ./configure
30                In das base/ Verzeichniss wechseln und das ./configure Skript aufrufen. Optional
31                koennen dem configure-Skript Parameter mitgeben (siehe unten)
32
33        2. make
34                'make' aufrufen, um die DarwinPorts Infrastruktur zu kompilieren. Um
35
36        3. sudo make install
37                'sudo make install' aufrufen, um die in Schritt 1 kompilierte Infrastruktur
38
39        4. [optional] /etc/ports/ports.conf editieren
40                Die Haupt-Konfigurationsdatei fuer DarwinPorts heisst 'ports.conf' und
41                liegt im Verzeichniss '/etc/ports'. In der Konfigurationsdatei ist festgelegt,
42                unterhalb welchem Verzeichnisses (Prefix) Software aus den DarwinPorts installiert
43                wird und wo DarwinPorts-spezifische Daten gespeichert werden:
44   
45                portdbpath - legt fest wo DarwinPorts-spezifische Daten gespeichert werden.
46                prefix - legt das Verzeichniss fest, wo DarwinPorts-Software installiert wird.
47
48        5. [optional] /etc/ports/sources.conf editieren
49                In der Datei '/etc/ports/sources.conf' wird angegeben, wo
50                das 'dports/'-Verzeichniss liegt. Dieses muss angepasst werden,
51                damit das DarwinPorts System benutzt werden kann! Falls das Argument
52                --with-dports-dir=DIR beim Aufrufen des ./configure-Skript angegeben wurde,
53                wurde dies Verzeichniss der sources.conf hinzugefuegt, ansonsten wurde
54                das default-Verzeichniss (darwinports/dports innerhalb des Installations
55                Verzeichnisses) hinzugefuegt.
56
57    Die DarwinPorts Infrastruktur wird an folgenden Stellen installiert:
58        [Mac OS X 10.2] /System/Library/Tcl/darwinports1.0
59        [Mac OS X 10.3] /Library/Tcl/darwinports1.0
60        [FreeBSD] /usr/local/lib/tcl8.3/darwinports1.0
61            - TCL Bibliothek zum Zugriff auf das DarwinPorts System.
62   
63    PREFIX ist per default auf '/opt/local' gesetzt, kann aber durch das Wechseln
64    in das base/-Verzeichnis und einem anschliessendem, manuellen Aufruf des ./configure-
65    Skriptes, bei dem das '--prefix'-Argument angegeben wird, veraendert werden.
66   
67    Folgende Komponenten werden im PREFIX installiert:
68     
69        $PREFIX/bin/port
70            - Kommandozeilen Utility zum Managen von DarwinPorts.
71        $PREFIX/share/darwinports/
72        - interne TCL Bibliotheken fuer das DarwinPorts System.
73
74        Folgende Konfigurations-Dateien werden verwendet:
75
76        /etc/ports/ports.conf
77                - allgemeine Konfigurationsdatei
78        /etc/ports/sources.conf
79            - enthaelt Pfade zu dports/-Verzeichnissen
80
81DAS PORT KOMMANDO BENUTZEN
82   
83    Falls noch nicht geschehen, sollte /opt/local/bin der 'path'-Variablen
84    hinzugefuegt werden (oder $PREFIX/bin, falls das Prefix explizit bei
85    der Installation angegeben wurde).
86
87    Falls Jaguar (OS X 10.2) verwendet wird, folgende Zeile der Datei
88    '~/.cshrc' hinzufuegen (gilt fuer alle (t)csh Benutzer):
89
90    set path=($path /opt/local/bin)
91
92        Falls Panther (OS X 10.3) verwendet wird, folgende Zeile der Datei
93        '~/.profile' hinzufuegen (gilt fuer alle sh/bash Benutzer):
94
95        export PATH=$PATH:/opt/local/bin
96
97    Aenderungen an der ~/.cshrc werden erst beim Starten einer neuen Shell
98    beruecksichtigt.
99
100    Folgendes Kommando kompiliert und installiert einen Port:
101
102        port install <portname>
103
104    Um einen bestimmen Port zu finden, kann man 'port search' verwenden:
105
106        port search vi
107
108    Die Man-Page des 'port'-Kommandos listet alle verfuegbaren Befehle auf.
109    Desweiteren ist es moeglich, Aktionen (z.B. kompilieren oder herunterladen)
110    fuer alle vorhandenen Ports mittels des 'portall'-Kommandos auszufuehren.
111    Das 'portall'-Kommando verarbeitet alle Aktionen wie das 'port'-Kommando,
112    mit dem Unterschied, dass es iterativ alle ports im dports/-Verzeichniss
113    abarbeitet.
114
115ERSTELLEN VON NEUEN PORTS
116
117    Ports bestehen aus einem Verzeichniss mit einem 'Portfile' und dazugehoerigen
118    Dateien. Zur Zeit sind die einzigen Dateien, ausser dem 'Portfile', Patches.
119
120    Ein Portfile besteht auf gueltigem TCL, interpretiert von einem TCL-Interpreter,
121    der vom DarwinPorts-System gestartet wird. Portfiles benutzen eine key/value
122    Syntax, geben dem Portfile-Autor aber gleichzeitig die kompletten Moeglichkeiten
123    von TCL.
124   
125    Einen guten Einstieg in das Erstellen von Ports gibt die Man-Page portfile(7),
126    base/doc/exampleport und http://ww.opendarwin.org/projects/darwinports/en/portfileHOWTO.php.
Note: See TracBrowser for help on using the repository browser.