.\" Manuel de hopmanrc.
.\" Contacter kryn@in2p3.fr pour corriger les erreurs.
.TH man 8 "07 may 2019" "1.0" "Manuel de hopmanrc"
.SH NAME
hopmanrc
Fichier de configuration de hopman.
.SH DESCRIPTION
Ce manuel décrit le fichier de configuration de hopman. Ce fichier de
configuration est recherché au démarrage par hopman, dans le répertoire de base
de l'utilisateur (home) sous le nom .hopmanrc . Si ce fichier n'existe pas, une
configuration valable pour l'ensemble du système est recherchée dans /etc/default/hopmanrc.
Si aucun de ces fichiers n'existe, une configuration par défaut est utilisée.
.br
La syntaxe de définition des paramètres est "<nom-du-parametre> = <valeur>",
avec une définition par ligne. Les lignes ne respectant pas cette syntaxe sont
ignorées, ainsi que les lignes commençant par le caractère '#' et les lignes
vides.
.br
Les espaces ou tabulations au début et à la fin des lignes sont optionnels et
ignorés, ainsi que ceux entourant le signe '=' de la définition du
paramètre. La taille des caractères, majuscule ou minuscule, est ignorée en
ce qui concerne les noms des paramètres et les valeurs booléennes, "true" et
"false". Par contre les lignes de commandes (scripts) sont strictement
respectées et transmises au shell /bin/sh après substitution des caractères de
conversion qu'elles contiennent.
.br
 
.br
.ul 1
Paramètres textuels:
.IP - 2      
MountHelper: une ligne de commande pour monter une partition
.IP -
UmountHelper: une ligne de commande pour démonter une partition
.IP -
FileManager: une ligne de command pour ouvrir le répertoire courant avec
l'explorateur de fichiers.
.IP -
TerminalEmulator: une ligne de commande pour ouvrir le répertoire courant dans
un émulateur de terminal.
.IP -
PidFile: Le nom complet (chemin) du fichier contenant le numéro de process
(pid).
.RE
.br

.br
.ul 1
Paramètres entiers:
.IP - 2
MountCheckPeriod: période (en secondes) à laquelle hopman vérifie quelles
partitions sont montées. Si la valeur est 0, les points de montage ne sont
vérifiés que lorsque l'utilisateur a demandé le montage ou démontage d'une
partition.
.RE
.br

.br
.ul 1
Paramètres booléens:
.IP - 2
ShowName: afficher le nom des partitions (nom du fichier spécial dans /dev).
.IP -
ShowLabel: afficher le label du système de fichier contenu dans la partition.
.IP -
ShowFstype: afficher le type du système de fichier (connu seulement quand
celui-ci est monté).
.IP -
ShowMountPoint: afficher les points de montage.
.IP -
Sticky: Afficher la fenêtre de hopman sur tous les bureaux.
.IP -
Autohide: cacher automatiquement la fenêtre quand auncune partition extractible
n'est connectée.
.IP -
ToggleHide: changer la visibilité de la fenêtre quand le process reçoit le
signal SIGHUP. Si la valeur est "False", SIGNUP provoque inconditionnellement
l'affichage de la fenêtre.
.IP -
Debug: Ecrire la liste des partitions sur la sortie standard d'erreur à chaque
fois qu'elle change.
.IP -
Decorate: décorer la fenêtre avec un titre et des boutons.
.IP -
KeepPosition: Si la fenêtre a été déplacée par l'utilisateur, se souvenir de sa
position quand la fenêtre est cachée et la remettre à la même position quand
elle est de nouveau affichée. Voir aussi InitialPosition et les notes.
.RE
.br
 
.br
.ul 1
Position initiale de la fenêtre
.IP - 2
InitialPosition: ce paramètre peut prendre la forme de deux nombres entiers
compris dans l'intervalle [0..100], indiquant les positions horizontale et
verticale en pourcentage des dimensions de l'écran, ou la valeur spéciale
"Mouse" (indiférement en minuscules ou majuscules), ce qui signifie que la
fenêtre doit apparitre à l'endroit indiqué par le pointeur de la souris.
.RE
.br
 
.br
.SH NOTES
.ul 1
Valeurs textuelles:
Les valeurs de variables contextuelles peuvent être insérées dans le texte
par le moyen de spécifications de conversion formées de deux caractères:
.IP \[bu] 2
%u and %h peuvent être insérés dans tous le textes et seront remplacés
respectivement par le nom d'utilisateur et par son répertoire de base (home).
.IP \[bu] 2
%n, %l, and %m peuvent être insérés dans toutes les lignes de commande et
seront remplacés respectivement par le nom de la partition, le label du
système de fichiers qu'elle contient et son point de montage.
.RE
.br

.br
.ul 1
Valeurs booléennes:
Il n'y a pas de message d'erreur en cas de valeur erronnée. Toute valeur autre
que "true" est considérée comme "false".
.br

.br
.ul 1
Paramètres d'affichage:
Si ShowName et ShowLabel sont "false" tous les deux, un des deux est affiché 
quand même, le label s'il existe, sinon le nom.
.br

.br
.ul 1
Fichier de numéro de process (pid):
Tous les répertoires sur le chemin de ce fichiers sont automatiquement créés
par hopman s'ils n'existent pas et si l'utilisateur en a la permission. Quand
hopman se termine, il ne détruit que le fichier, pas les répertoires.
.br

.br
.ul 1
Placement de la fenêtre:
Si une position initiale de la fenêtre est spécifiée, elle est toujours
utilisée au premier affichage de la fenêtre. Quand la fenêtre est cachée puis
affichée de nouveau, le placement dépend alors de la valeur du paramètre
KeepPosision. Si KeepPosition a la valeur "false", alors la valeur initiale
est toujours utilisée, sinon la fenêtre est rétablie à l'endroit où elle était
avant d'être cachée.
.SH FICHIERS
/etc/default/hopmanrc, .hopmanrc
.SH VOIR AUSSI
hopman
.SH AUTEUR
Didier Kryn <kryn@in2p3.fr>
