ROX-Filer 2.10 - Manuel de l'utilisateur http://rox.sourceforge.net/Manual/Manual/Manual-fr.html

Si vous voulez que le filer gère votre bureau vous utiliserez l'option --pinboard et fournirez un nom pour le punaiseur, e.g. :

$ rox --pinboard=MonPunaiseur

La configuration du punaiseur est sauvée dans `~/.config/rox.sourceforge.net/ROX-Filer/pb_MonPunaiseur' dès que vous le modifiez (par exemple, en glissant/déposant un fichier sur votre bureau). Vous pouvez avoir autant de punaiseurs que vous le souhaitez et basculer de l'un à l'autre en lançant rox de nouveau, e.g. :

$ rox --pinboard=MonAutrePunaiseur

Pour arrêter la fonction punaiseur, donnez au nom une chaîne vide :

$ rox --pinboard=

Allez voir la section window manager notes si vous avez des problèmes d'affichage avec les icônes. Le punaiseur peut aussi être activé/désactivé en se plaçant dans le répertoire d'installation de `ROX-Filer' dans une fenêtre du filer et en choisissant Enable pinboard ou Disable pinboard dans le menu (clic droit).

Les panneaux fonctionnent exactement de la même façon que les punaiseurs, mais ils correspondent à une barre, le long d'un des bords de l'écran. Pour créer un panneau :

$ rox -b=MonPanneau

Le panneau devrait être affiché dans une fenêtre sans barre de titre. Si ça ne fonctionne pas, lisez la section window manager notes pour avoir quelques idées. Vous pouvez déposer des fichiers sur les 2 côtés du panneau, ils s'aligneront sur un côté ou sur l'autre. Les icônes des panneaux peuvent être repositionnées en les glissant avec le bouton du milieu. Les changements apportés au panneau sont automatiquement sauvegardés dans `~/.config/rox.sourceforge.net/ROX-Filer/pan_MonPanneau'. Comme pour le punaiseur, vous pouvez basculer entre plusieurs configurations de panneaux en relançant rox avec un nom de panneau différent.

$ rox -b=MonAutrePanneau

Utilisez le menu contextuel pour choisir le côté sur lequel vous souhaitez positionner le panneau. Vous pouvez aussi utiliser le nom du côté ("bottom", "top", "left" ou "right"), au lieu de -b. Spécifiez une chaîne vide ("") pour ôter le panneau :

$ rox --bottom=

Vous allez peut être avoir à configurer un peu votre gestionnaire de fenêtre pour que les icônes des punaiseurs et les panneaux s'affichent correctement (c'est-à-dire sans les bordures et sous les autres fenêtres). En particulier, vérifiez les options concernant les différentes "couches" (au-dessus, en dessous, premier, dernier, etc...) et affectez le punaiseur aux couches les plus basses.

(require 'gnome)

# Manage root window (EXPERIMENTAL - normally enabled!)
GrabRootWindow=1 # 0/1
# Bitmask of root window button click to use in window manager
UseRootButtons=3 # [0-255]
# Desktop mouse-button click to show the menu
DesktopWinMenuButton=1 # [0-20]
# Desktop mouse-button click to show the window list
DesktopWinListButton=2 # [0-5]
# Desktop mouse-button click to show the window list menu
DesktopMenuButton=0 # [0-20]

# ROX-Filer pinboard and panel
ROX-Filer.icon: folder
ROX-Panel.layer: Dock
ROX-Panel.doNotCover: 1
ROX-Panel.ignoreWinList: 1
ROX-Panel.ignoreTaskBar: 1
ROX-Panel.ignoreQuickSwitch: 1
ROX-Pinboard.layer: Below
ROX-Pinboard.ignoreWinList: 1
ROX-Pinboard.ignoreTaskBar: 1
ROX-Pinboard.ignoreQuickSwitch: 1
ROX-Filer.layer: Normal

Si vous utilisez le filer en tant qu'utilisateur 'root', le filer affiche un message en haut de chaque fenêtre pour vous le rappeler. L'utilisateur root a le droit d'accéder à tous les fichiers du systèmes, ainsi que de les modifier, soyez donc très vigilant quand vous utilisez le filer dans ces conditions. Normalement, vous devriez vous loguer en utilisateur ordinaire et vous changer en root que lorsque vous en avez besoin. Si sudo est installé et proprement configuré sur votre système, vous pouvez exécutera le filer de cette façon :

$ sudo rox

Attention, souvenez-vous que tout ce que vous ferez sur n'importe quel fichier (y compris les applications que vous exécuterez depuis ces fenêtres) sera effectué avec les droits de root ! Soyez très prudent !

Vous aurez peut-être un message du serveur X window qui vous dira que root (ou d'autres utilisateurs) ne peut pas se connecter (ndt : "se connecter à X", ce qui veut dire que l'utilisateur root, par exemple, ne pourra lancer aucune commande qui utiliserait X). Une lecture des pages man pour xauth et xhost est donc conseillée, mais ce mécanisme varie selon les systèmes (c'est pourquoi ça n'est pas imtégré dans le filer !).

Note : La commande gnomesu peut aussi être utilisée pour exécuter le filer en tant que root, mais vous devrez employer setsid pour le démarrer dans une nouvelle session, sinon gnomesu le détruira avant qu'il n'ouvre la moindre fenêtre. Exemple :

gnomesu -c 'setsid /usr/local/bin/rox /'

Il est parfois utile de sauvegarder la sélection courante pour une utilisation ultérieure. Vous pouvez en enregistrer 10 en appuyant sur Ctrl+<chiffre>. Vous pouvez restaurer une sélection en appuyant seulement sur le chiffre utilisé. Vous pouvez aussi restaurer des sélections si un dossier différent est affiché, et même si vous utilisez une fenêtre différente.

Cette fonction de sauvegarde est très utile même si rien n'est sélectionné, puisque le filer enregistre quand même le nom du dossier courant.

Les groupes sont automatiquement enregistrés et seront donc accessibles pour une autre session du filer.

Si vous ouvrez le menu alors que plusieurs objets sont sélectionnés, l'opération s'applique alors à tous ces objets. Si vous ouvrez le menu en cliquant droit sur un objet, alors qu'il n'y a pas de sélection, l'objet cliqué est alors temporairement sélectionné.

Si vous choisissez une commande du menu sélection sans qu'il n'y ait de sélection, vous entrez en mode 'cible' ; l'opération choisie s'appliquera au prochain objet choisi. Cliquez sur le fond de la fenêtre, appuyez sur Echap ou faites un clic droit pour sortir du mode 'cible'. Le mode 'cible' est surtout utile si vous utilisez l'option Navigation en simple clic ou pour utiliser avec des raccourcis claviers.

Notez que pour les dossiers-applications, il peut y avoir quelques commandes qui sont ajoutées au début de ce sous-menu quand vous cliquez sur ceux-ci — voir la section Application directories pour plus de détails. Vous pouvez créer des commandes supplémentaires qui apparaîtront en haut, en fonction du type de fichier sur lequel vous aurez cliqué. Pour cela, choisissez la commande Personnaliser. Par exemple, vous pourriez faire apparaître The Gimp pour toutes les images, et FreeFS pour les points de montage.

Note à propos des liens symboliques :  Un lien symbolique enregistre l'emplacement d'un autre fichier/dossier. Supprimer un lien symbolique n'affecte en rien la cible vers laquelle celui-ci pointe. Supprimer la cible rendra le lien symbolique inutile. Il y a deux types de liens symboliques — Relatif et Absolu. Un lien absolu enregistre le chemin complet de la cible (ex `/home/fred/MonFichier'). Un lien relatif enregistre le chemin relatif menant jusqu'à la cible (ex `../fred/MonFichier'). Si la cible est censée ne jamais être déplacée, utilisez un lien absolu (vous pourrez déplacer celui-ci), mais si vous pensez que la cible peut être déplacée (le lien devra l'être aussi...), alors optez pour un lien relatif.

Chaque commande de ce sous-menu ouvre une boîte pour créer un nouveau fichier ou un nouveau dossier. Il y a trois commandes de base ; les autres reflètent le contenu de votre dossier `~/.config/rox.sourceforge.net/Templates', s'il existe.

Pour ajouter vos propres commandes, choisissez Personnaliser le menu... et enregistrez-y tous les fichiers que vous souhaitez. Chaque fichier de ce dossier apparaîtra dans le menu et la boîte qui s'ouvrira le copiera. Par exemple, vous pourriez créer une base pour un fichier HTML :

<html>
  <head>
    <title>Ma Page</title>
  </head>
  <body>
    Le contenu.
  </body>
</html>

Enregistrez ceci sous le nom `index.html' dans le dossier `Templates' et vous pourrez ainsi facilement créer de nouveaux fichiers HTML. Vous pouvez aussi y enregistrer des documents vides de toutes sortes d'applications (e.g. : une feuille de calcul, une lettre ou un fax, etc...).

Notez que pour l'instant, vous ne pouvez pas créer de raccourcis-clavier pour ces commandes personnalisées.

Le menu 'Envoyer à...' permet d'envoyer très facilement un (des) objet(s) à une application. Le filer cherche le dossier `$XDG_CONFIG_DIRS/rox.sourceforge.net/SendTo' (voir [BaseDir]) et liste son contenu dans ce menu.

Pour changer les applications qui apparaissent ici, vous pouvez utiliser la commande Personnaliser qui se trouve en bas du menu ; elle créera si nécessaire le dossier `SendTo' et l'ouvrira. Vous pouvez placer dans ce dossier des liens symboliques en glissant/déposant des applications et en choisissant Lier dans le menu qui apparaît.

L'affichage du menu 'Envoyer à...' via le menu principal est plutôt lent ; vous devriez l'ouvrir en cliquant sur un fichier avec le bouton droit en maintenant la touche Shift enfoncée.

Le menu signets trouve son utilité dans la mémorisation de chemins de dossiers souvent utilisés. Vous pouvez aussi ouvrir ce menu depuis le menu principal (dans le sous-menu Fenêtre) et vous pouvez donc y affecter un raccourci-clavier. Dans ce menu, vous pouvez choisir d'ajouter à la liste le dossier actuellement affiché, d'aller directement dans un des dossiers enregistrés, ou bien d'ouvrir une boîte de dialogue vous permettant de modifier cette liste. Dans cette boîte, vous pouvez retirer des dossiers de la liste, les classer (en utilisant les flèches ou en les faisant glisser) et modifier les chemins directement si vous le souhaitez.

Le sous-menu Récemment visités propose un historique des derniers dossiers affichés, dans lesquels vous pouvez vous rendre d'un simple clic. Le dossier actif, s'il est dans ce sous-menu, est désactivé puisque vous êtes déjà dans celui-ci.

Si vous mettez en place les icônes par défaut pour plusieurs utilisateurs et que vous souhaitez créer une icône 'Home' qui pointe vers le dossier personnel de chaque utilisateur, créez une icône, choisissez Éditer l'icône et mettez `~' pour le chemin.

Notez que des applications peuvent ajouter des commandes au début de ce menu quand vous cliquez dessus — voir la section Application directories pour plus de détails.

ROX-Filer vous permet d'exécuter de petits programmes à l'intérieur des panneaux — ces programmes sont appelés appliquettes. Pour démarrer une appliquette, glissez-déposez-la sur un panneau, depuis une fenêtre du filer et au lieu de voir l'icône apparaître, vous verrez l'appliquette démarrer.

Quand le punaiseur est utilisé, ROX-Filer peut afficher une icône pour chaque fenêtre iconisée (ou "réduite"). Vous pouvez activer/désactiver cette fonctionnalité dans la boîte Options. Les icônes des fenêtres réduites sont sur un fond semi-transparent et peuvent être déplacées à la souris. Si vous cliquez sur une de ces icônes, celle-ci reprendra la taille normale de l'application qu'elle représente. Quelques anciens gestionnaires de fenêtres ne sont pas compatibles avec cette fonctionnalité, et n'affichent donc pas ces icônes.

Vous pouvez choisir une image de fond pour le punaiseur en choisissant Image de fond... dans le menu du punaiseur (clic droit sur le bureau quand le punaiseur est activé).

Pour choisir une image, choisissez Centrer, Redimensionner, Étirer ou Paver pour le style, puis faites glisser une image dans l'emplacement prévu. Pour retrouver un bureau avec une simple couleur (définie dans la boîte Options), cliquez sur Effacer.

L'application [Wallpaper] peut être utilisée pour appliquer des effets avancés, comme choisir une nouvelle image aléatoirement toutes les heures, ou afficher une image de la Terre grâce au programme xearth, par exemple.

Pour les programmeurs...  Si vous voulez créer une application qui gère le fond d'écran (par exemple pour choisir une image au hasard ou pour faire un diaporama), vous devez d'abord créer un dossier-application (voir Application directories).

Exécutée sans argument, l'application doit invoquer la méthode SOAP SetBackdropApp (voir Annexe C, SOAP RPC). Le filer ré-exécutera immédiatement l'application, cette fois avec l'option --backdrop.

Exécutée avec l'option --backdrop, l'application doit afficher le style et le nom de l'image utilisée sur sa sortie standard, ie :

tile /tmp/image.png

centre et scale sont les 2 autres styles acceptés. Le filer va ensuite charger cette image et l'afficher. L'application ne gère pas l'affichage de l'image, elle indique seulement au filer quoi afficher.

Dans le cas d'une application qui choisirait une image aléatoirement, elle peut s'arrêter immédiatement. Si l'application a créé une image temporaire, elle doit lire la ligne "ok\n" sur son entrée standard avant d'effacer l'image.

Si l'application doit afficher une séquence d'images, elle doit toujours lire "ok\n", puis attendre jusqu'à ce que le moment soit venu d'afficher l'image suivante, afficher le nom du fichier, et ainsi de suite.

Le filer indiquera à l'application qu'elle doit s'arrêter en fermant les deux "flux" (entrée et sortie). L'application devra alors nettoyer et sortir proprement à ce moment. Vérifiez que SIGPIPE soit bien géré quand vous écrivez sur la sortie standard si vous devez supprimer des fichiers temporaires.

Voyez l'application [Wallpaper] pour un exemple détaillé (écrit en python).

En mode 'Imagettes', ROX-Filer vérifie le dossier `~/.thumbs/normal' pour chaque fichier passé en revue. Si une vignette existe, il la charge et passe au fichier suivant.

Pour générer la vignette d'un fichier de type media/subtype, le filer recherche un exécutable nommé `~/.config/rox.sourceforge.net/MIME-thumb/media_subtype', en se rabattant sur `~/.config/rox.sourceforge.net/MIME-thumb/media' s'il ne le trouve pas. Si aucun des deux ne peut être trouvé et que le fichier est du type image/*, les routines internes sont alors utilisées. Si le fichier n'est pas du type image/*, la vignette ne sera pas générée.

Si l'exécutable est trouvé, il est démarré avec les paramètres

thumbnailer /path/to/source/file /path/to/thumbnail pixel_size

.

Quand celui-ci est terminé, le filer essaie de charger `/path/to/thumbnail'. En cas d'échec, la vignette n'est pas montrée.

Notez les nombreuses étapes nécessaires ! ROX-Filer utilisera volontiers une vignette existante, même s'il ne sait pas comment celle-ci a été générée.

Vous pouvez taper un chemin, directement. Au fur et à mesure que vous tapez, l'affichage de la fenêtre est mis à jour pour vous montrer l'objet qui correspond à ce que vous êtes en train de taper. L'utilité de cette commande réside dans la recherche d'un fichier dans un dossier très fourni, mais vous pouvez vous en servir pour passer directement à un autre dossier, ou pour coller un chemin complet que vous aurez copié depuis une autre fenêtre.

Si vous commencez à taper un nom commençant par un '.', la commande Montrer les fichiers cachés est temporairement activée pour que les fichiers puissent être affichés.

La complétion essaie de trouver le maximum de caractères possibles. Par exemple, s'il y a deux fichiers dans un même dossier qui s'appellent `save-mail-nov-1999' et `save-mail-dec-1999', alors le simple fait de taper save et de presser la touche Tabulation développera save en save-mail- et bipera pour indiquer que la correspondance n'est pas complète. Si vous utilisez la complétion sur un dossier et qu'il est unique, le filer va automatiquement afficher celui-ci. Ce comportement doit rappeler quelque chose aux utilisateurs du shell.

Cette fonction vous permet d'entrer rapidement des commandes shell si vous ne voulez pas ouvrir d'xterm. Si vous ne savez pas ce que sont des "commandes shell", passez à la section suivante !

Tapez simplement la commande et pressez Entrée pour l'exécuter. Les touches Haut et Bas rappellent les commandes précédentes. Tab effectue toujours la complétion. Cliquer sur un objet insère son nom dans le mini-buffer. Si plusieurs objets sont sélectionnés, ils sont assignés aux paramètres $1, $2, etc.

Ouvrir le mini-buffer alors que des objets sont sélectionnés ajoute "$@" à la fin de la commande — ce qui remplace le nom des objets sélectionnés.

Utilisez cette commande si vous voulez sélectionner des objets correspondant à certains critères.

Tous les fichiers (et seulement eux) plus gros que 5 Mb seront sélectionnés. Les expressions que vous pouvez utiliser ici sont du même style que celles décrites à la section Searching, sauf que prune n'a aucun effet, puisque le contenu des dossiers n'est jamais vérifié. Vous pouvez utiliser Tab pour passer d'un objet sélectionné à un autre, en boucle.

Certaines actions ont des options, qui apparaissent sous forme de petites cases à cocher en bas de la fenêtre :

Vous pouvez définir la valeur par défaut de ces options.

Vous pouvez aussi entrer des wildcards entre les apostrophes, par exemple :

Lisez la page man de glob(7) (ndt : 'man 7 glob') si vous voulez en savoir plus sur les motifs génériques.

Si l'expression que vous entrez contient un slash ('/'), la recherche porte sur le chemin complet des objets, au lieu de ne porter que sur le nom de l'objet. Donc, '*tmp*' trouvera `tmp' et `tmpfile' mais pas `/tmp/file' — '/*tmp*' trouvera les trois.

Le filer propose d'autres types de recherche (pas seulement par le nom). Notez que file est utilisé ici pour tout ce qui peut être dans le système de fichiers — y compris les répertoires, les fichiers de périphérique (devices) et autres...

Vous pouvez aussi utiliser une forme courte pour chaque test ; celle-ci est écrite entre parenthèses. Vous pouvez combiner plusieurs tests — -rw donnera le même résultat que EstLisible et EstInscriptible.

Vous pouvez combiner les tests précédents pour effectuer des recherches avancées. Une expression est actuellement faite d'une liste de cas, séparés par des virgules. Le filer essaiera de trouver les correspondances pour chaque cas jusqu'à ce qu'un de ceux-ci fonctionne, ou jusqu'à ce qu'il n'y ait plus de cas. Par exemple, pour chercher des fichiers dont les extensions peuvent être différentes :

'*.gif', '*.htm', '*.html'

Plus fort : chaque cas peut être une liste de conditions. Le cas ne fonctionne que si toutes les conditions sont respectées. Pour trouver un dossier nommé `lib' ou un fichier normal se terminant par `.so' :

EstRép 'lib', EstOrd '*.so'

Vous pouvez inverser une condition en ajoutant un ! devant, et vous pouvez utiliser une sous-expression comme expression, en l'entourant de parenthèses, comme ceci :

!(EstRép, EstOrd)

!EstRép !EstOrd

Non EstRép et non EstOrd

!-d !-f

Ces 4 expressions signifient la même chose.

Vous pouvez aussi comparez des valeurs en utilisant les opérateurs <, <=, =, !=, >, et >= (inférieur à, inférieur ou égal à, égal à, différent de, supérieur à, supérieur ou égal à). Quand vous comparerez des heures, vous trouverez certainement plus pratique d'utiliser après et avant au lieu de > et <.

Les heures sont mesurées en secondes, avec un point de départ correspondant à 'Unix Epoch' (1er janvier 1970 à 00:00:00 UTC). Les tailles sont en octets. Quand vous utilisez des constantes pour comparer les valeurs, vous pouvez utiliser plusieurs mots-clés pour ajuster l'échelle de la valeur :

Quelques exemples rendront tout ceci plus clair !

mtime après 1 jour passé

taille > 10 Mo

EstOrd et nliens > 1

La première expression trouve les fichiers modifiés au cours des dernières 24 heures. Vous pourriez utiliser > au lieu de après, mais ce serait moins clair.

La deuxième trouve les fichiers pesant plus de 10 Mo. La dernière trouve les fichiers normaux qui ont plus qu'un lien physique sur eux.

Attention — le filer ne vérifie pas le contexte des opérateurs, donc taille > 1 jour passé est admis, même si ça n'a pas de sens ! Pensez aussi aux mots-clés passé ou futur, car un oubli de ceux-ci pourrait causer des problèmes conséquents (le temps serait alors mesuré par rapport à l'Epoch au lieu de l'heure courante). Enfin, n'utilisez pas = avec les heures — atime = 1 jour passé recherche un fichier accédé il y a exactement 86400 secondes...

Exemples :

'*.old' system(rm '%')

'src' prune, '*.c'

La première expression supprime chaque fichier ayant pour extension `.old'. La seconde cherche les fichiers ayant pour extension `.c', mais ne prend pas la peine de vérifier le contenu des dossiers nommés `src'. L'expression est évaluée comme suit :

Si un fichier est nommé `src', alors `Prune'. D'autre part, vérifie s'il se termine par `.c' et dans ce cas, l'inclut dans les résultats.

Cette commande du menu Fichier est utilisée pour définir l'application à exécuter quand vous cliquez sur un fichier.

Par exemple, admettons que vous vouliez que les `.gif' s'ouvrent automatiquement avec 'The Gimp'. D'abord, faites un clic droit sur une image gif pour ouvrir le menu, et choisissez la commande Fixer l'action d'exécution... dans le sous-menu Fichier (celui qui prend le nom du fichier sur lequel vous avez cliqué). Ensuite, vous pouvez fixer l'action d'exécution de deux façons différentes :

Cette boîte apparaît quand vous choisissez la commande Fixer l'icône... du menu Fichier. Elle permet de définir une image pour représenter l'objet.

Elle fonctionne un peu de la même façon que la boîte 'Fixer l'action d'exécution' décrite ci-dessus, sauf que vous pouvez affecter une icône pour un fichier précis (par son nom), ou pour tous les fichiers d'un type particulier. Si vous affectez une icône à un fichier précis, le filer enregistre les noms de ce fichier et de cette icône dans le dossier `~/.config/rox.sourceforge.net/MIME-icons'. Si l'un ou l'autre est déplacé, l'icône ne sera plus affichée.

Quand vous affectez une icône à un répertoire, vous avez la possibilité de copier cette icône dans le dossier lui-même, en tant que fichier caché. Les autres utilisateurs verront aussi cette icône, vous pouvez donc supprimer l'image originale après sa copie (notez que la taille de l'image est ajustée si nécessaire et convertie au format PNG).

L'icône de dossier affichée dans la zone Faites glisser ici un fichier d'icône vous permet d'afficher un dossier qui contient déjà une ou plusieurs icônes dont vous vous servez.

ROX-Filer utilise deux sous-dossiers dans votre dossier `~/.config/rox.sourceforge.net' pour gérer les types de fichier :

Dans le dossier `MIME-types', vous pouvez définir les actions par défaut pour chaque type de média. Par exemple, si `text_html' n'est pas trouvé, le filer essaiera simplement d'utiliser `text'.

Le filer utilise la plupart du temps le nom du fichier pour déterminer son type. En cas d'échec, il essaiera de trouver d'après le contenu du fichier. Si vous ne souhaitez pas qu'il essaie de cette manière, fixez le type correct du fichier en utilisant les attributs étendus, grâce à la commande Fixer le type....

Pour gérer les règles utilisées pour déterminer le type d'un fichier en fonction de son nom, ouvrez la boîte Options et sélectionnez la section Types. Vous y trouverez un bouton qui démarrera l'application MIME-Editor. Vous pouvez aussi éditer ces règles manuellement — voir [SharedMIME] pour plus de détails. Le filer cherche le type d'un fichier en fonction de son nom. Les règles sont définies dans plusieurs fichiers `globs' — voir [SharedMIME] pour plus de détails.

`AppInfo.xml' est un fichier XML avec la structure suivante (chaque élément est facultatif, ainsi que le fichier lui-même) :

<?xml version="1.0"?>
<AppInfo>
 <Summary xml:lang="en">A graphical file manager</Summary>
 <Summary xml:lang="de">Ein grafische Datei-Manager</Summary>
 <Summary xml:lang="nl">Een grafisch bestandsbeheerprogramma</Summary>
 <Summary xml:lang="es">Un manejador de archivos gráafico</Summary>	 
 <About xml:lang="en">
    <Purpose>File manager</Purpose>
    <Version>1.3.5 PREVIEW</Version>
    <Authors>Thomas Leonard and others</Authors>
    <License>GNU General Public License</License>
    <Homepage>http://rox.sourceforge.net</Homepage>
 </About>
 <About xml:lang="es">
	<Purpose>Manejador de Archivos</Purpose>
	<Authors>Thomas Leonard y otros</Authors>
 </About>
 <AppMenu>
	<Item option="-p=Default">
	  <Label>Enable pinboard</Label>
	  <Label xml:lang="es">Habilitar el pinboard</Label>
    </Item>
	<Item option="-p=">
	  <Label>Disable pinboard</Label>
	  <Label xml:lang="es">Deshabilitar el pinboard</Label>
	</Item>
  </AppMenu>
</AppInfo>

ROX-Filer est capable de traduire beaucoup de ses messages, pourvu que des fichiers de traduction corrects soient fournis :

Lisez la page info de gettext pour de plus amples instructions sur la création de traductions.

La première fois que vous compilerez, vous devrez exécuter AppRun --compile, mais les fois suivantes, un make dans le dossier `src' quand vous changerez les fichiers `.c' et `.h' suffira. Vous voudrez peut-être exécuter aussi un make depend...

Quand les développeurs apportent de petites modifications aux sources, ils les distribuent souvent sous forme de patches — souvent sur la liste de diffusion. Pour appliquer un patch, allez dans le dossier `src' et exécutez la commande patch avec le nouveau patch. Recompilez ensuite :

$ cd ROX-Filer/src
$ patch < patchfile
$ ../AppRun --compile

Vous pouvez retirer le patch en répétant simplement la séquence ci-dessus — patch détectera que le patch est déjà appliqué, et proposera de l'enlever.

Pour créer un patch vous devrez d'abord vous procurer la dernière version du filer sur CVS (les instructions pour l'utilisation de CVS peuvent être trouvées sur le site web). Modifiez le programme comme bon vous semble. Créez le patch en utilisant cvs diff depuis le dossier approprié :

$ cvs diff -u > my_patch

Ceci crée un patch lisible par l'homme – et la machine. Soumettez-le à la liste de diffusion. Il est recommandé de poster des patches plutôt que les fichiers modifiés, pour plusieurs raisons :

Voici une explication rapide du système autoconf au cas où vous ne l'auriez pas déjà utilisé. Voir info autoconf pour plus de détails.

Un fichier nommé `configure.in' est fourni et contient plusieurs tests (info autoconf). Vous n'avez qu'à exécuter autoconf il lira ce fichier et générera un script shell pour effectuer les tests, en le sauvant sous le nom de `configure'. `configure' est normalement distribué avec le programme car tout le monde n'a pas autoconf.

Vous exécutez ensuite `configure' (en fait, laissez le script `AppRun' le faire car il lui passe quelques arguments), qui effectue tous les tests. Il lit `Makefile.in' et `config.h.in' et complète les valeurs manquantes avec les résultats des tests pour produire `Makefile' et `config.h'.

Exécutez make, qui créera les fichiers `.o' à partir des fichiers `.c' et les liens pour créer `ROX-Filer'.

Le fichier `global.h' contient les principales structures de données de ROX-Filer et explique la façon dont elles sont utilisées dans le code-source. C'est un bon point de départ si vous voulez comprendre son fonctionnement.