Hi, Nemeth Gyorgy wrote: > It is better if you call them 'info'. This is already exists,
Well, "info" is the pet of GNU and thus often better documentation for GNU tools than their "man" pages. The goal and viewpoint is nevertheless the same: Technical documentation of programs, not tutorial. The reason why many large man pages or info documents are so hard to grasp is really in the difference of viewpoints. Too much background knowledge and too exotic programmer's motivations, i assume. I maintain about 8000 lines of man pages for own programs. (Fattest: https://www.gnu.org/software/xorriso/man_1_xorriso.html ) Nevertheless i suffer like most other people when i have to study foreign technical docs for the first time. So it is not dumb user versus smart programmer but rather insider versus newcommer. ------------------------------------------------------------------------ If the contest for the name of a new documentation system is still open: How about "Mandie" ? Goals would be to be appealing: http://vignette3.wikia.nocookie.net/fairlyoddparents/images/f/f3/NewSquidInTown014.jpg/revision/latest?cb=20110908204439&path-prefix=en as well as authoritative: http://vignette3.wikia.nocookie.net/fairlyoddparents/images/7/72/NewSquidInTown214.jpg/revision/latest?cb=20110908212027&path-prefix=en (Pronounciation is: "Man-Die") Have a nice day :) Thomas
