source: trunk/README.fr @ 12092

Last change on this file since 12092 was 12092, checked in by jmpp, 14 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.7 KB
Line 
1QU'EST-CE QUE DARWINPORTS
2
3        DarwinPorts est une infrastructure permettant de compiler,
4        d'installer et d'empaqueter un logiciel, similaire en termes de
5        fonctionnalités à l'architecture des ports FreeBSD afin de
6        maintenir une extensibilité future.
7
8        DarwinPorts fonctionne et permet d'être compilé sur MacOS X 10.2
9        (Darwin 6.0) et MacOS X 10.3 (Darwin 7.0.0). Le système est
10        portable, et est écrit en TCL avec un set limité d'extensions TCL
11        en C.
12
13                Le "DarwinPorts User Guide" est disponible à :
14                http://darwinports.opendarwin.org/docs
15       
16        Pour une documentation plus appronfondie sur l'architecture
17        interne de ce système de ports, reportez-vous au fichier
18        base/docs/INTERNALS.
19
20        Notez svp que l'architecture de DarwinPorts est composé de deux
21        parties. "L'infrastructure de DarwinPorts", qui réside dans le
22        sous-répertoire base/ est le seul composant obligatoire du système,
23        et le répertoire "dports" qui contient la description des logiciels
24        portés. Le dernier composant peut être optionnel et peut être
25        récupéré sur le net ou une copie locale peut également être
26        utilisée.
27        Reportez-vous à la documentation sur ${prefix}/etc/ports/sources
28        .conf ci-dessous.
29
30INSTALLATION
31
32        Pour des instructions d'installation spécifiques à d'autres
33        plateformes, reportez-vous au fichier base/docs/README.platforms.
34
35    Étapes de l'installation :
36
37        1. cd base/
38           ./configure
39                Vous place dans le répertoire base/ et lance le script
40                configure. Des paramètres peuvent être passés au script
41                (cf. ci-dessous).
42
43        2. make
44        Lancez 'make' pour compiler tout ce qui est nécessaire.
45
46        3. sudo make install
47                Lancez 'sudo make install' pour installer DarwinPorts
48                sur votre système.
49
50        4. [optionnel] éditez ${prefix}/etc/ports/ports.conf
51                Le fichier de configuration "${prefix}/etc/ports/ports.conf"
52                définit la majeure partie des options de configuration de
53                l'infrastructure de DarwinPorts si vous desirez changer les
54                chemins et emplacements ou sonts stockés les données,
55                changez les options suivantes :
56
57                portdbpath - Spécifie la base où stocker les données
58                spécifiques au système de ports.
59
60                prefix - Indique la base dans laquelle installer les ports
61               
62        5. [optionnel] éditez ${prefix}/etc/ports/sources.conf
63                Le fichier "${prefix}/etc/ports/sources.conf" liste l'emplacement               des hiérarchies des ports locales et distantes. Si l'argument
64                "--with-dports-dir=RÉP." n'a pas été utilisé lors du
65                lancement du script "./configure", la hiérarchie de dports
66                (darwinports/dports, depuis la copie que vous avez
67                installé) sera ajoutée au fichier "source.conf".
68
69    Tout le code TCL nécessaire sera compilé et installé comme indiqué ci-
70    dessous:
71        [Mac OS X 10.2] /System/Library/Tcl/darwinports1.0
72        [Mac OS X 10.3] /Library/Tcl/darwinports1.0
73        [FreeBSD]       /usr/local/lib/tcl8.3/darwinports1.0
74                        - Librairie TCL permettant d'interagir avec le
75                          système DarwinPorts.
76
77        ${prefix} est situé par défaut à /opt/local mais ce choix peut être
78        modifié en changeant le répertoire  pour base/ et en lançeant
79        manuellement ./configure avec l'argument --prefix
80
81        ${prefix}/bin/port
82                - Utilitaire en mode texte pour la compilation de port
83        ${prefix}/share/darwinports/
84                - Librairies TCL internes du système de ports
85
86        Les fichiers suivants sont fournis en vue de la personnalisation
87        du système :
88
89        ${prefix}/etc/ports/ports.conf
90            - Réglages personnels des ports pour les utilisateurs
91        ${prefix}/etc/ports/sources.conf
92            - Liste des sources pour les ports (endroit où récupérer les
93              données des ports)
94
95
96UTILISATION DE LA COMMANDE 'PORT'
97
98    Si vous ne l'avez déjà fait, ajoutez /opt/local/bin à votre variable
99    path (ou ${prefix}/bin si vous avez choisi d'installer DarwinPorts dans
100    un autre emplacement). Si vous ne savez pas comment faire, ajoutez la
101    ligne suivante dans votre fichier ~/.cshrc (cela est valable si vous
102    utilisez tcsh sous Panther également). Si ce fichier n'existe pas,
103    créez-le.
104
105        set path=($path /opt/local/bin)
106
107    Si vous utilisez Panther (OSX 10.3), ajoutez la ligne suivante à votre
108    fichier ~/.profile (cela est valable si vous utilisez un shell de type
109    Bourne sous Jaguar également). Si ce fichier n'existe pas, créez-le.
110
111        export PATH=$PATH:/opt/local/bin
112
113    Vos changements ne seront pris en compte que lorsque vous ouvrirez un
114    nouveau shell.
115
116    La commande suivante compilera et installera le port :
117
118        port install <nom_du_port>
119
120    Pour rechercher un port spécifique, essayez d'utiliser "port search" :
121
122        port search vi
123
124    Référez-vous à la page man de port(1) pour une documentation plus
125    complète sur cette commande.
126
127    Il est également possible d'effectuer des opérations, comme compiler
128    ou récupérer tous les ports du système en utilisant la commande
129    "portall". Elle prend les mêmes arguments essentiels que la commande
130    "port" mais opère de façon interactive sur chaque port dans dports/.
131
132CRÉER DE NOUVEAUX PORTS
133
134    Un port consiste en un répertoire contenant un fichier Portfile et ses
135    fichiers associés. Actuellement les seuls fichiers livrés avec un port
136    sont les patchs, et sont au minimum censés être gardés.
137
138    Un fichier Portfile consiste en un code TCL valide, évalué par un
139    interpréteur de DarwinPorts. Les fichiers Portfiles utilisent une
140    syntaxe très stricte composée de paires de type clé/valeur, permettant
141    d'autoriser à l'auteur l'utilisation complète des fonctionnalités
142    offertes par TCL lorsque cela lui est nécessaire.
143
144    Pour commencer reportez-vous au fichier base/doc/exampleport et la page
145    man de portfile(7).
Note: See TracBrowser for help on using the repository browser.