ROX-Filer 1.3.3 - Manuel de l'utilisateur http://rox.sourceforge.net

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

$ rox --pinboard=MonPunaiseur

La configuration du punaiseur est sauvée dans `<Choices>/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, ex :

$ 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. Vous pouvez créer un panneau sur n'importe quel côté de l'écran en utilisant les options --left, --right,, --top et --bottom, (respectivement pour les non-anglophones 'gauche', 'droite', 'haut' et 'bas'), en fonction du côté sur lequel vous souhaitez voir apparaître votre panneau. Sur certains systèmes, vous devrez utiliser l'option courte (une lettre). Par exemple, pour créer un panneau en bas de votre écran :

$ 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 `<Choices>/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. Spécifiez une chaîne ville pour ôter le panneau.

$ rox --bottom=MonAutrePanneau
$ 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 implémenté dans le filer !).

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.

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 deux commandes de base ; les autres reflètent le contenu de votre dossier `<Choices>/Templates', s'il existe.

Pour ajouter vos propres commandes, créez un nouveau dossier `~/Choices/Templates' (si la variable CHOICESPATH est celle par défaut) 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 (ex : 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 `SendTo' dans votre CHOICESPATH 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 avec les touches Control et Shift maintenues enfoncées.

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.

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 mises en surbrillance quand vous passez la souris au-dessus d'elles et elles peuvent être déplacées. Si vous cliquez sur une d'elles, celle-ci reprendra la taille normale de l'application qu'elle représente. Quelques vieux 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 `Centrée', `Redimensionnée' ou `Pavée' 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.

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 B. 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.

Cet exemple affiche une image de la Terre en fond d'écran, en l'actualisant toutes les minutes. Notez les trois endroits qui gèrent le test de la connexion avec le filer : en envoyant l'image, en attendant des infos, et en étant en veille. Ce fichier devrait être enregistré sous le nom `AppRun' à l'intérieur de votre nouveau dossier-application. Pour changer le fond d'écran, exécutez l'application (ie : cliquez dessus).

#!/usr/bin/env python

import sys, os

if len(sys.argv) == 1:
    # Become the backdrop application
	app = os.path.abspath(os.path.dirname(sys.argv[0]))
	cin = os.popen('rox -R', 'w')
	cin.write("""<?xml version="1.0"?>
<env:Envelope xmlns:env="http://www.w3.org/2001/12/soap-envelope">
  <env:Body xmlns="http://rox.sourceforge.net/SOAP/ROX-Filer">
   <SetBackdropApp><App>""" + app + """</App></SetBackdropApp>
  </env:Body>
</env:Envelope>
""")
    sys.exit(0)
elif len(sys.argv) != 2 or sys.argv[1] != '--backdrop':
	sys.stderr.write("Usage: %s [--backdrop]\n" % sys.argv[0])
	sys.exit(1)

# If we get here, we've been run by the filer.
# Generate a sequence of images, sending them to the filer one by one.

import tempfile, time, signal
from select import select

time_between_updates = 60

while 1:
    # Write image to a temporary file
	path = tempfile.mktemp('.ppm')
	child = os.fork()
	if child == 0:
		fd = os.open(path, os.O_CREAT | os.O_WRONLY | os.O_TRUNC, 0600)
		os.dup2(fd, 1)
		os.execvp("xearth", ["xearth", "-ppm"])
		os._exit(1)
	pid, status = os.waitpid(child, 0)
	if status:
		break       # xearth didn't work

	# Send message to filer
	quit = 0
	try:
		print "centre " + path
		sys.stdout.flush()
		if sys.stdin.readline() != 'ok\n':
			quit = 1        # filer closed connection
	except:
		quit = 1            # filer closed connection
	# Delete temporary file
	os.unlink(path)
	if quit:
		break

    # Wait until the next image is due, or the filer tells us to quit
	ready = select([sys.stdin], [], [], time_between_updates)[0]
    if ready:
		# filer closed connection while we were waiting
		break

	

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 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 IsReadable and IsWriteable.

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' :

IsDir 'lib', IsReg '*.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 :

!(IsDir, IsReg)

!IsDir !IsReg

Not isdir and not isreg

!-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 after (ndt : après) et before (ndt : 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 after 1 day ago

size > 10 Mb

IsReg and nlinks > 1

La première expression trouve les fichiers modifiés au cours des dernières 24 heures (ndt : 'after 1 day ago', littéralement, veut dire 'après il y a un jour'). Vous pourriez utiliser > au lieu de after, mais ce serait moins clair.

La deuxième trouve les fichiers pesant plus de 10 Mb. 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 size > 1 day ago est admis (ndt : 'taille > 1 jour avant'), même si ça n'a pas de sens ! Pensez aussi aux mots-clés ago ou hence (ndt : 'il y a' et 'désormais'), 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 day ago 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.

Vous pouvez choisir ici dans quelle langue le filer affiche les messages, ou choisir d'utiliser la variable d'environnement LANG pour obtenir la langue désirée.

Voir la section Pinboard support pour savoir comment activer le punaiseur.

Si vous utilisez des panneaux (voir la section Panel support), vous pouvez choisir ici quelles icônes auront un texte affiché sous elles. Vous pouvez choisir d'afficher du texte sous toutes les icônes, sous aucune, ou sous toutes sauf les applications.

Vous pouvez choisir le démarrage automatique de certaines opérations, c'est-à-dire sans que vous ne deviez cliquer sur Silencieux. Sélectionnez les opérations que vous voulez voir démarrer automatiquement. Vous pouvez aussi définir les options par défaut pour chacune des options des fenêtres action.

`Ignorer le bit 'eXécutable' pour les extensions connues' signifie que si un fichier a une extension connue (par exemple `.gif'), le 'bit exécutable' est ignoré. Un tel comportement est utile si vous avez des fichiers sur un système de fichiers de type Windows qui sont montrés comme des programmes exécutables. Par contre, cette option empêche un fichier du type `script.sh' d'être traité comme un programme.

Le système de types MIME utilisé par le filer est décrit plus en détails à la section Chapitre 14. Types de fichier.

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 `Choices'. 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 Choices pour gérer les types de fichier :

Dans les dossiers `MIME-types' et `MIME-icons', vous pouvez définir les actions/images 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 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>A graphical file manager</Summary>
  <About>
    <Purpose>File manager</Purpose>
    <Version>1.1.3 (07-May-2001)</Version>
    <Authors>Thomas Leonard and others</Authors>
    <License>GNU General Public License</License>
    <Homepage>http://rox.sourceforge.net</Homepage>
  </About>
  <AppMenu>
    <Item label="Enable pinboard" option="-p=Default"/>
    <Item label="Disable pinboard" option="-p="/>
  </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'.

The `global.h' file lists each major data-structure used in the filer and explains its purpose. This is a good place to start reading if you want to know how the filer works.

In summary, each window has its own FilerWindow structure. This structure has pointers to a Collection (which is the widget which actually displays the files) and to a Directory, which is used to cache the directory contents.

Both Collection and Directory have pointers to (the same) DirItems, each of which corresponds to one filesystem object.

Several FilerWindows may share the same Directory.

While scanning is in progress the Directory keeps a list of the new items it has found (new_items) and the items which have changed in some way (up_items). It periodically notifies the filer window of the changes-so-far by calling all the functions in the users list (use attach() and detach() to add and remove functions to or from the list).