Discussion :

[marty499]

Bonjour ,
je cherche en faite un crééer une man page...
Sur internet je ne trouve rien de concluant à ce sujet...
Merci à tous

[matafan]

Tu peux les écrire à la main avec n'importe quel éditeur. C'est du format troff. En général tu peux te contenter de prendre une page de man qui ressemble à ce que tu veux faire, et de la modifier.

[troumad]

Voici un exemple (man xrandr) :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
.\"
.\" Copyright 2001 Keith Packard.\"
.\" Permission to use, copy, modify, distribute, and sell this software and its
.\" documentation for any purpose is hereby granted without fee, provided that
.\" the above copyright notice appear in all copies and that both that
.\" copyright notice and this permission notice appear in supporting
.\" documentation, and that the name of Keith Packard not be used in
.\" advertising or publicity pertaining to distribution of the software without
.\" specific, written prior permission.  Keith Packard makes no
.\" representations about the suitability of this software for any purpose.  It
.\" is provided "as is" without express or implied warranty.
.\"
.\" KEITH PACKARD DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
.\" INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
.\" EVENT SHALL KEITH PACKARD BE LIABLE FOR ANY SPECIAL, INDIRECT OR
.\" CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
.\" DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
.\" TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\" PERFORMANCE OF THIS SOFTWARE.
.\"
.\"
.\" $XFree86: xc/programs/xrandr/xrandr.man,v 1.6 2003/06/12 14:12:39 eich Exp $
.\"
.TH XRANDR 1x "xrandr 1.2.0" "X Version 11"
.SH NOM
xrandr \- interface primitive en ligne de commande pour l'extension RandR
.SH SYNOPSIS
.B "xrandr"
[-help]  [-display \fIdisplay\fP]
[-q] [-v]
[--verbose]
[--screen \fIsnum\fP]
.br
.B options de la version 1.3 de RandR
.br
[--panning <largeur>x<hauteur>[+\fx\fP+\fy\fP[/\flargeur_piste\fPx\fhauteur_piste\fP+\fpiste_x\fP+\fpiste_y\fP[/\fbord_gauche\fP/\fbord_haut\fP/\fbord_droit\fP/\fbord_bas\fP]]]]
.br
.B options de la version 1.2 de RandR
.br
[--prop]
[--fb <largeur>x<hauteur>]
[--fbmm <largeur>x<hauteur>]
[--dpi <dpi>]
.br
.B options par sortie
.br
[--output <sortie>]
[--auto]
[--mode <mode>]
[--preferred]
[--pos <x>x<y>]
[--rate <rate>]
[--reflect \fIreflection\fP]
[--rotate \fIorientation\fP]
[--left-of <sortie>\]
[--right-of <sortie>\]
[--above <sortie>\]
[--below <sortie>\]
[--off]
[--crtc <crtc>]
.br
.B options des versions 1.0 et 1.1 de RandR
.br
[-o \fIorientation\fP]
[-s \fIsize\fP]
[-x] [-y]
.SH DESCRIPTION
.I Xrandr
sert à déterminer la taille de l'écran, son orientation et/ou sa réflexion. Il y a quelques options globales ; les autres modifient une sortie particulière et suivent les spécifications de la ligne de commande pour cette sortie. 
.IP --help
Affiche un résumé sur l'utilisation, et se termine normalement.
.IP -v
Affiche la version de RandR supportée par le serveur X et sort.
.IP --verbose
vous dit ce que xrandr fait, sélectionne les événements, et vous dit quand les événements sont reçus pour activer le débogage. Quand il est utilisé avec -q (ou sans autres options), xrandr montrera plus d'informations sur l'état de serveur. Quand il est utilisé avec les options qui modifient le système, les modifications seront affichées tout en exécutant les changements de configuration.
.IP "-q (sans autres options)"
Quand cette option est présente, ou quand aucun changement de configuration n'est demandé, xrandr montrera l'état actuel du système.
.IP "-screen snum"
Cette option choisit quelle configuration d'écran modifier. Noter que ceci se rapporte à la configuration de l'affichage, mais pas au comportement du moniteur.
.SH options de la version 1.3 de RandR
.B Options par sortie
.IP --panning "<largeur>x<hauteur>[+\fx\fP+\fy\fP[/\flargeur_piste\fPx\fhauteur_piste\fP+\fpiste_x\fP+\fpiste_y\fP[/\fbord_gauche\fP/\fbord_haut\fP/\fbord_droit\fP/\fbord_bas\fP]]]"
Cette option définit les paramètres panoramiques. Dès que le panorama est activé, la position du CRTC peut changer dès que la position de la souris bouge. Les quatre premiers paramètres précisent le nombre de zone panoramique, les quatre suivants, la zone de suivi (qui est la même par défaut). Les quatre derniers, les bords, à 0 par défaut. La hauteur ou la largeur fixée à 0 désactive le panorama sur l'axe associé. Généralement, vous devez fixer la taille de l'écran avec \f--fb\fP en même temps.
.PP
.SH options de la version 1.2 de RandR
Ces options ne sont disponibles que pour les serveurs X fournis avec les versions de RandR 1.2 ou plus récentes.
.IP "--prop"
Cette option fait afficher par xrandr les propriétés de chaque sortie  --verbose permet aussi --prop.
.IP "--fb <largeur>x<hauteur>"
Reconfigure l'écran à la taille spécifiée. Tous les moniteurs configurés doivent loger dans ce rectangle. Quand cette option n'est pas fournie, xrandr calcule la plus petite taille d'écran qui contiendra l'ensemble des sorties configurées\ ; cette option permet de configurer ce comportement.
.IP "--fbmm <largeur>x<hauteur>"
Configure la taille physique de l'écran. Normalement, xrandr remet à zéro ces valeurs pour garder la constante de DPI. Ceci annule ce comportement par défaut.
.IP "--dpi <dpi>"
Configure aussi la taille physique de l'écran. Il utilise la valeur DPI pour calculer la taille physique de l'écran quoiqu'une taille physique en pixels doive être configurée. 
.PP
.B Options par sortie
.IP "--output <sortie>"
Sélectionne la sortie à reconfigurer. Employer le nom de la sortie ou le XID.
.IP --auto
Pour les sorties connectées mais neutralisées, ceci les activera en employant leur mode préféré (ou, quelque chose autour de 96 dpi si elles n'ont aucun mode préféré). Pour les sorties débranchées mais activées, ceci les neutralisera.
.IP "--mode <mode>"
Ceci selectionne un mode.  Employer le nom ou le XID du mode.
.IP --preferred
Selectionne le même mode que --auto, mais n'active ou ne désactive pas automatiquement la sortie.
.IP "--pos <x>x<y>"
Position de la sortie  dans l'écran en utilisant des coordonnées en Pixel.
.IP "--rate <rate>"
Ceci marque une préférence pour des vitesses de rafraîchissement autour de la valeur indiquée, quand les modes multiples ont le même nom, ceci choisira le mode le plus proche avec la vitesse de rafraîchissement.
.IP "--reflect symétrie"
La symétrie peut être 'normal', 'x', 'y' ou 'xy'. Ceci effectue une symétrie par rapport aux axes indiqués.
.IP "--rotate rotation"
Rotation peut être 'normal', 'left', 'right' ou 'inverted'. Ceci génère respectivement une rotation de la sortie 'sans rotation' , 'à gauche', 'à droite' ou 'à l'envers'.
.IP "--left-of, --right-of, --above, --below <autre_sortie>"
Utiliser une de ces options pour placer la sortie active relativement à une autre sortie, respectivement à gauche, à droite  au-dessus, au-dessous. Ceci permet un placement commode des sorties dans l'écran. La position est toujours calculée relativement à la nouvelle position de l'autre sortie. Ainsi, il n'est pas admissible d'indiquer --output a --left-of b --output b --left-of a.
.IP --off
Désactive la sortie
.IP "--crtc <crtc>"
Emploie le crtc indiqué (comme indexé dans la liste de CRTCs ou de XID). Normalement, cette option n'est pas exigée pendant que le xrandr essaye de faire les choix sensibles au sujet dont crtc à employer avec chaque sortie. Quand cela échoue pour quelque raison, cette option peut remplacer le choix normal. 
.PP
.SH Options de la version 1.1 de RandR
Ces options sont disponibles pour les serveurs X qui ont la version 1.1 de RandR ou une plus ancienne. Elles sont toujours valides pour les versions plus récentes, mais elles ne sont pas recommandées. 
.IP "-s <index de taille> ou <largeur>x<hauteur>"
Configure la taille de l'écran en utilisant l'index dans la liste de tailles disponibles ou la taille exacte.
.IP "-o rotation"
spécifier l'orientation de l'écran, et peut être choisie parmi "normal "inverted" "left" ou "right"
.IP -x
Inversion de l'image sur l'axe des X.
.IP -y
Inversion de l'image sur l'axe des Y. 
.SH "VOIR AUSSI"
Xrandr(3)
.SH AUTEURS
Keith Packard,
et
Jim Gettys, 
Cambridge Research Laboratory, HP Labs, HP.
.SH TRADUCTION
 
Ce document est une traduction, réalisée par Gérard Delafond  le 06\ mars\ 2005 et par Bernard SIAUD le 20\ mai\ 2007.
 
L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité.
 
La version anglaise la plus à jour de ce document est toujours consultable via la commande : LANGUAGE=en man xrandr
 
N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans de cette page de manuel.

Mais, une fois que j'ai ce code, je fais comment pour le mettre à sa place ? Dans le bon format : /usr/share/man/fr/man1/xrandr.1x.lzma
Peut-être que depuis le format a changé ?

Je me pose des questions car il me semble que avant, c'était en bz 2 !

[matafan]

Le fichier va normalement sous /usr/share/man/manX (X est la section du document), ou /usr/share/man/LANG/manX (LANG est la langue du document) s'il n'est pas en anglais.

On peut laisser le document décompressé (toto.1 par exemple), ou bien le compresser au format compress (toto.1.z), gzip (toto.1.gz), bzip2 (toto.1.bz2) ou lzma (toto.1.lzma). En général sous linux on trouve du bz2, mais on fait comme on veut. Vu que les fichiers sont généralement petits, bzip2 compresse souvent légèrement mieux que lzma.

[ovh]

Merci de consulter les pages cours de la rubrique, tu aurais trouvé la réponse à ta question :
http://oregnier.developpez.com/cours...-sous-openbsd/

(pour bsd, mais ça ne change rien)