man?

Le 05/28/11 10:01, Tanguy Briançon a écrit :

Bonjour,

Je trouve que les pages man (et info) sont quelques
choses de très précieux et de très pratiques! On veut utiliser
une commande puis le système répond "Syntax error". Ok cette
commande ne marche pas comme je pensais donc je fais man la commande
pour en savoir plus...

Sur deux logiciels, libres et importants les pages man sont
soit d'une pauvreté absolue: vlc, soit inexistante,
mozilla n'a pas de pages man (c'est peux être mon système?).

Pourquoi il te faut une page man pour vlc et firefox?

T'arrive pas a les faire fonctionner ?ha ha

Tanguy Briançon <briancon_tanguy@yahoo.fr> wrote:

Bonjour,

Je trouve que les pages man (et info) sont quelques
choses de très précieux et de très pratiques! On veut utiliser
une commande puis le système répond "Syntax error". Ok cette
commande ne marche pas comme je pensais donc je fais man la commande
pour en savoir plus...

Sur deux logiciels, libres et importants les pages man sont
soit d'une pauvreté absolue: vlc, soit inexistante,
mozilla n'a pas de pages man (c'est peux être mon système?).

C'est un troll? Aucun (!) des logiciels libres modernes importants
n'a de page man (ou du moins de pages de man dignes de ce nom).
Un exemple frappant étant KDE, qui a des documentations extrêmement
pauvres dans un autre format, tout étant supposé tellement "intuitif"
qu'il n'y a pas besoin de doc. Les gnuteries sont documentées
préférentiellement au format info, souvent les pages man sont converties
par des outils automatiques depuis le format info. Pour ce qui est de
la programmation entre le contenu des pages man et rien du tout la
différence est minime, on va te dire, va voir Stevens, Butenhof, ou
la Single UNIX Specification, pour d'autres choses tu as droit à des
exemples au hasard du web ou de l'essai et erreur. Bref personne n'a
envie de se farcir d'écrire une documentation sérieuse, ce qui
d'ailleurs est un métier en soi. Les anciens Unix commerciaux, notamment
HP-UX avaient de merveilleuses documentations parceque les gens étaient
payés pour l'écrire. Un des points forts de python est d'avoir une
documentation assez valable (tant du moins qu'on ne va pas chercher du
coté des appels système convertis pour python, auquel cas la doc se
réfère aux pages man (!) du système). Un des points faibles de lisp est
d'avoir une documentation
http://www.lispworks.com/documentation/HyperSpec/Front/
proche du rébus. Heureusement existe un ouvrage à peu prés intelligible:
http://www.gigamonkeys.com/book/


--

Michel TALON

Michel Talon, dans le message <irqdhm$js4$1@asmodee.lpthe.jussieu.fr>, a
écrit :

C'est un troll? Aucun (!) des logiciels libres modernes importants
n'a de page man (ou du moins de pages de man dignes de ce nom).

Définis « important ». ffmpeg est certainement l'un des logiciels libres les
plus importants qui soient, et sa page de man est riche et maintenue à jour
tout à fait régulièrement (merci Stefano).

Pour ce qui est de
la programmation entre le contenu des pages man et rien du tout la
différence est minime, on va te dire, va voir Stevens, Butenhof, ou
la Single UNIX Specification

Là, tu dis juste des conneries. Les pages de man des fonctions et outils
standard de GNU/Linux ressemblent comme deux gouttes d'eau à leur
contrepartie dans Single Unix, même la présentation est similaire. La seule
différence, c'est que l'un document le comportement standard tandis que
l'autre document le comportement de la version précise concernée.

Quant à « va voir Stevens », c'est juste que manifestement tu n'as pas
compris qu'une page de man avait vocation à être une référence, pas plus, et
en particulier pas un didacticiel. La page de man d'accept(2), par exemple,
décrit le comportement de l'appel système accept, pas plus. Tu vas la
consulter pour savoir le type précis de son troisième argument ou les codes
de retour possibles ; mais si tu veux apprendre comment accept s'agence avec
bind et listen pour faire un serveur réseau qui marche, il faut consulter
une documentation qui prend une vue d'ensemble, et ce n'est pas le rôle
d'une page de man.

On 28/05/2011 10:59, Michel Talon wrote:

Tanguy Briançon<briancon_tanguy@yahoo.fr> wrote:

Bonjour,

Je trouve que les pages man (et info) sont quelques
choses de très précieux et de très pratiques! On veut utiliser
une commande puis le système répond "Syntax error". Ok cette
commande ne marche pas comme je pensais donc je fais man la commande
pour en savoir plus...

Sur deux logiciels, libres et importants les pages man sont
soit d'une pauvreté absolue: vlc, soit inexistante,
mozilla n'a pas de pages man (c'est peux être mon système?).

C'est un troll?Aucun (!) des logiciels libres modernes importants
n'a de page man (ou du moins de pages de man dignes de ce nom).

On est d'accord.

Cela dit mplayer est un logiciel libre et moderne. Il a une page man
(en français!) qui explique bien des choses.

Un exemple frappant étant KDE, qui a des documentations extrêmement
pauvres dans un autre format, tout étant supposé tellement "intuitif"
qu'il n'y a pas besoin de doc. Les gnuteries sont documentées
préférentiellement au format info, souvent les pages man sont converties
par des outils automatiques depuis le format info.

L'inverse est vrai aussi. Je pense que info est capable de reprendre
les pages man. Je n'ai rien contre info cela dit (au contraire!).




Pour ce qui est de

la programmation entre le contenu des pages man et rien du tout la
différence est minime, on va te dire, va voir Stevens, Butenhof, ou
la Single UNIX Specification, pour d'autres choses tu as droit à des
exemples au hasard du web ou de l'essai et erreur. Bref personne n'a
envie de se farcir d'écrire une documentation sérieuse, ce qui
d'ailleurs est un métier en soi. Les anciens Unix commerciaux, notamment
HP-UX avaient de merveilleuses documentations parceque les gens étaient
payés pour l'écrire.

La pauvreté des documentations actuelles est (hélas)
un fait. Si on compare la documentation d'un apple //e
et celle de mon dernier pc...

Un des points forts de python est d'avoir une

documentation assez valable (tant du moins qu'on ne va pas chercher du
coté des appels système convertis pour python, auquel cas la doc se
réfère aux pages man (!) du système). Un des points faibles de lisp est
d'avoir une documentation
http://www.lispworks.com/documentation/HyperSpec/Front/
proche du rébus. Heureusement existe un ouvrage à peu prés intelligible:
http://www.gigamonkeys.com/book/

Je ne connait rien au python ni au lisp. Sur le lisp
(Lot of Insane and Stupid Parenthesis)
je connais seulement si il est polonai et inversé!

On 28/05/2011 10:38, yves wrote:

Le 05/28/11 10:01, Tanguy Briançon a écrit :

Bonjour,

Je trouve que les pages man (et info) sont quelques
choses de très précieux et de très pratiques! On veut utiliser
une commande puis le système répond "Syntax error". Ok cette
commande ne marche pas comme je pensais donc je fais man la commande
pour en savoir plus...

Sur deux logiciels, libres et importants les pages man sont
soit d'une pauvreté absolue: vlc, soit inexistante,
mozilla n'a pas de pages man (c'est peux être mon système?).

Pourquoi il te faut une page man pour vlc et firefox?

T'arrive pas a les faire fonctionner ?ha ha

Pour vlc je voulais avoir les raccourcis claviers (pour le
son, avencer/reculer, passer en mode plein écran etc...).
Je trouve simple de faire
mplayer film.avi
puis f pour l'avoir en plein écran et / ou * pour le son.
Dans le man de mplayer on nous donne tout ça...

Pour Mozilla c'était juste un test...

Le 28/05/2011 12:55, Tanguy Briançon a écrit :

On 28/05/2011 10:38, yves wrote:

Le 05/28/11 10:01, Tanguy Briançon a écrit :

Bonjour,

Je trouve que les pages man (et info) sont quelques
choses de très précieux et de très pratiques! On veut utiliser
une commande puis le système répond "Syntax error". Ok cette
commande ne marche pas comme je pensais donc je fais man la commande
pour en savoir plus...

Sur deux logiciels, libres et importants les pages man sont
soit d'une pauvreté absolue: vlc, soit inexistante,
mozilla n'a pas de pages man (c'est peux être mon système?).

Pourquoi il te faut une page man pour vlc et firefox?

T'arrive pas a les faire fonctionner ?ha ha

Pour vlc je voulais avoir les raccourcis claviers (pour le
son, avencer/reculer, passer en mode plein écran etc...).
Je trouve simple de faire
mplayer film.avi
puis f pour l'avoir en plein écran et / ou * pour le son.
Dans le man de mplayer on nous donne tout ça...

Pour Mozilla c'était juste un test...

Tu peux faire cvlc film.avi pour lire un film ou de la
musique en ligne de commande. Sinon tu peux trouver pas
mal d'information sur Internet concernant vlc.

Le Sat, 28 May 2011 12:55:45 +0200, Tanguy Briançon a écrit :

Pour vlc je voulais avoir les raccourcis claviers (pour le son,
avencer/reculer, passer en mode plein écran etc...).

La liste est consultable en GUI dans Outils -> Préférences -> Raccourcis
Sinon, pour découvrir les options dispo en CLI, vaut mieux faire un :
vlc --help (ou "cvlc --help")
voire (attention, sortie _très_ longue) :
vlc -H

T.

On 28/05/2011 13:54, florian wrote:

Le 28/05/2011 12:55, Tanguy Briançon a écrit :

On 28/05/2011 10:38, yves wrote:

Le 05/28/11 10:01, Tanguy Briançon a écrit :

Bonjour,

Je trouve que les pages man (et info) sont quelques
choses de très précieux et de très pratiques! On veut utiliser
une commande puis le système répond "Syntax error". Ok cette
commande ne marche pas comme je pensais donc je fais man la commande
pour en savoir plus...

Sur deux logiciels, libres et importants les pages man sont
soit d'une pauvreté absolue: vlc, soit inexistante,
mozilla n'a pas de pages man (c'est peux être mon système?).

Pourquoi il te faut une page man pour vlc et firefox?

T'arrive pas a les faire fonctionner ?ha ha

Pour vlc je voulais avoir les raccourcis claviers (pour le
son, avencer/reculer, passer en mode plein écran etc...).
Je trouve simple de faire
mplayer film.avi
puis f pour l'avoir en plein écran et / ou * pour le son.
Dans le man de mplayer on nous donne tout ça...

Pour Mozilla c'était juste un test...

Tu peux faire cvlc film.avi pour lire un film ou de la
musique en ligne de commande. Sinon tu peux trouver pas
mal d'information sur Internet concernant vlc.

C'est précisément ce que j'avais fait. Je voulais donc
connaitre les raccourcis clavier. Je pensais
naivement que man donnerai la réponse (comme
il la donne pour mplayer).

On Sat, 28 May 2011 10:38:10 +0200, yves <local@fai.fr> wrote:

Le 05/28/11 10:01, Tanguy Briançon a écrit :

Bonjour,

Je trouve que les pages man (et info) sont quelques
choses de très précieux et de très pratiques! On veut utiliser
une commande puis le système répond "Syntax error". Ok cette
commande ne marche pas comme je pensais donc je fais man la commande
pour en savoir plus...

Sur deux logiciels, libres et importants les pages man sont
soit d'une pauvreté absolue: vlc, soit inexistante,
mozilla n'a pas de pages man (c'est peux être mon système?).

Pourquoi il te faut une page man pour vlc et firefox?

VLC peut faire beaucoup de chose en CLI et aussi avec le serveur
Web...



--
Le politiquement correct me fait gerber.
Je vais même aller chier un coup.
« le politiquement correct ne proclame pas la tolérance ; il ne fait qu'organiser la haine. » (Jacques Barzun)
C'est une doctrine obligatoire, qui n'est en réalité que l'expression la plus autoritaire du conformisme