🚲 Tanguy Ortolo a écrit 12091 commentaires

Si tu as une raison de ne pas utiliser l’encodage qui leur semble le plus courant pour ta langue, tu peux aller te faire voir.

Je ne sais pas sous Mandriva, mais sous Debian, les pages de manuel peuvent être codées en ASCII, en latin-1, en latin-9 ou en UTF-8, quelle que soit la locale que tu utilises, elles s'affichent correctement. Évidemment, les caractères inexistants dans ton codage sans translittérés, mais à part ce problème inévitable, tout baigne.

Sous Linux, un gars fait son outil, écrit une page man à l'arrachen en se disant que la vraie doc est sur son site perso (exemples, tout ça). Ensuite […]

Ensuite quelqu'un en fait un paquet Debian, rédige une page de manuel parce que c'est obligatoire, et la soumet à l'auteur orginal qui l'intègre. Quelque temps après donc, le logiciel original se retrouve distribué avec une page de manuel comprenant une section « About : This manpage was written by Untel for the Debian project. »

Tu ne fais que coder en C des programmes en ligne de commande pour t'auto-héberger ?

Quelle importance ? Je le fais, donc ce genre de documentation m'est utile, et je suis très loin d'être seul dans ce cas. Il m'arrive aussi de faire des trucs à la souris, mais ça n'enlève pas les besoins précédents.

Il y a plein de pages de manuel avec des exemples. C'est même une pratique plutôt courante, et s'il en manque pour certains logiciels, je pense que leurs développeurs d'amont seront ravis d'en intégrer si on leur en propose.

Le HTML me parait tout à fait approprier pour remplacer le vieux troff.

Non, il manque de sémantique pour les manuels. C'est exactement le même problème que nroff. Il existe à ma connaissance deux formats sémantiques pour les pages de manuel : DocBook et Linuxdoc.

Bref moderniser en changeant le moteur sous le capot, mais garder le man !

Il est possible de rédiger des pages de manuel en DocBook tout à fait moderne. Il y a des feuilles de style XSLT tout à faite correctes pour les convertir ensuite en nroff… ou en HTML, si le cœur t'en dit.

Le fait aussi que les gros projets genre KDE et Gnome n'utilisent pas man fait que celui-ci va de tout façon mourir sous linux

Merci. J'ai ri. Tu peux retourner toucher ta souris maintenant.

Ça fait plaisir à entendre ça. Il faudrait demander au mainteneur Debian pourquoi sa page de manuel n'a pas été intégrée dans la version d'amont. Soit il a oublié de l'envoyer, soit les développeurs d'amont sont cons.

1. Une combinaison de touches pour atteindre mon navigateur.
2. Une combinaison de touches pour ouvrir un nouvel onglet.
3. Un clic de la souris pour atteindre ma barre de recherche.
4. Un clic de la souris pour choisir le moteur Google, parce que ce n'est pas le seul que j'utilise (Wikipédia, Wiktionnaire, OpenStreetMap, paquets Debian…).
5. Je tape ma recherche et je valide.
6. Un clic de souris pour choisir la bonne page.

À comparer à :
1. Une combinaison de touches pour atteindre un émulateur de terminal ou en lancer un.
1. Je tape ma recherche et je valide.

Par ailleurs, si tu n'as pas de connexion à Internet, si Google est hors service ou si MSDN est hors service, tu es baisé. Moi pas.

C'est quoi les options de rsync déjà ? Quelle est la syntaxe de strcpy ? Quelles sont les options de configuration de Git ? Quelles sont des différentes définitions possibles des interfaces réseau sous Debian ? Comment est défini le format cpio ? Comment fait-on un ping avec un nombre limité de tentatives ?

C'est très peu ergonomique ça. Aucune mise en forme, pas de pageur… man intègre tout ça. Et si tu veux lire tranquillement une page de manuel un peu longue, man est capable de sortir du PostScript prêt à être imprimé.

Ils sont tous interchangeables, comme peuvent l'être Iceweasel, Chromium et Epiphany.

Boudu, ce troll…

ça va plus vite de chercher sur le net

Non. Vas-y, sous Windows, trouve-moi la syntaxe et la description de strcpy(). Moi je l'ai en moins d'une seconde.

Ça mériterait un sondage : ca fait combien de temps que vous avez consulté une page man ?

J'en consulte à peu près vingt fois pas jour.

Ne pas documenter une commande, c'est une violation de la charte Debian, et ça implique un bogue de gravité serious.

Très peu, je ne sais pas. Certains sont de mauvaise qualité en effet. Mais par ailleurs, d'autres sont non seulement de bonne qualité, mais ont été adopté par le projet amont. Debian est un moteur de documentation.

Dans ce cas, le mieux à faire est de signaler ces manques en faisant des rapports de bogue, niveau de gravité serious. Ces rapports devraient être traités assez rapidement par les mainteneurs correspondants étant donnés qu'ils sont bloquants pour l'admission ou le maintien d'un paquet dans Debian. Autrement dit, avec un bug sérieux, un paquet ne rentrera pas dans la prochaine Debian stable.

Évidemment, les correctifs sont les bienvenus. Un rapport de bogue, c'est bien, un rapport de bogue avec correctif, c'est mieux.

D'autant que fournir un manuel pour chaque commande est obligatoire, selon la charte Debian.

Sous Debian il y a d'après la FAQ dpkg < apt < aptitude < synaptic et tasksel, mais la FAQ n'explique pas comment utiliser ce dernier.

tasksel est fait pour l'installateur. C'est une interface de sélection de paquets, concurrente en cela à aptitude, synaptic et dselect qui est caduque.

Il y a aussi dpkg-deb et dpkg-split.

Rien à voir, dpkg-deb c'est pour inspecter, manipuler des paquets sans les installer. Quant à dpkg-split, je n'en avais jamais entendu parler, mais il a encore moins à voir, il sert à couper des paquets en plusieurs morceaux pour les transférer sur des disquettes trop petites pour les accueillir en entier.

« Upstream » se dit « amont », en français. Selon le contexte, ça donnes des expression comme « les développeurs amont » ou « la version amont ».

On n'écrit pas V.P.N. mais VPN.

S'il y a un outil approprié pour ce genre d'usage, c'est plutôt BitTorrent. Ensuite, il faut que les correspondant puissent l'utiliser, mais ils devraient en être capables : les utilisateurs debaze arrivent bien à installer Adobe Reader pour lire un PDF, donc installer Deluge pour télécharger des photos ne devrait pas leur faire peur.

Ce n'est pas le prix entre Dell et Microsoft qui doit être communiqué au consommateur, seulement le prix de revente pratiqué par Dell. Vendre sans afficher ses prix, c'est illégal.

Non, ça c'est le nom commercial, en fait c'est la 6.1.

le prix d'achat du mêm téléphone peut varier selon le forfait souscrit

Ça justement ça n'est pas normal, c'est interdit et ça donne lieu à des abus, du genre : portable à 1 euro, avec forfait obligatoire, et entube pour ceux qui ont déjà un téléphone.

Surtout qu'on a une boîte française qui commercialise un système sérieux pour faire cela. Basé sur Grub et je ne sais plus quoi d'autre, à tous les coups c'est un système qui chiffre et déchiffre les méta-données du système de fichiers. Pas le SF en entier, ce serait trop long : les méta-données sont suffisantes pour rendre le système parfaitement inutilisable sans la clef.