Gentoo Forums
Gentoo Forums
Gentoo Forums
Quick Search: in
Dokumentation lesen - wie?
View unanswered posts
View posts from last 24 hours
View posts from last 7 days

 
Reply to topic    Gentoo Forums Forum Index Deutsches Forum (German)
View previous topic :: View next topic  
Author Message
Slurm
n00b
n00b


Joined: 30 Jul 2004
Posts: 36

PostPosted: Wed Feb 09, 2005 12:06 pm    Post subject: Dokumentation lesen - wie? Reply with quote

Gibt es irgendein Tool, das die mit den Programmen mitinstallierte Dokumentation übersichtlich darstellt?

Also alles, was unter /usr/share/docs und auch sonst wo ist, auch manpages, ...
Back to top
View user's profile Send private message
b3cks
Veteran
Veteran


Joined: 23 Mar 2004
Posts: 1481
Location: Bremen (GER)

PostPosted: Wed Feb 09, 2005 12:12 pm    Post subject: Reply with quote

man !?

Beispiel:
Code:
man emerge

_________________
I am /root and if you see me laughing you better have a backup.
Back to top
View user's profile Send private message
dakjo
Veteran
Veteran


Joined: 31 Jan 2004
Posts: 1544

PostPosted: Wed Feb 09, 2005 12:16 pm    Post subject: Re: Dokumentation lesen - wie? Reply with quote

Slurm wrote:
Gibt es irgendein Tool, das die mit den Programmen mitinstallierte Dokumentation übersichtlich darstellt?

ls
Slurm wrote:

Also alles, was unter /usr/share/docs und auch sonst wo ist, auch manpages, ...

versuch vielleicht nach mal info.
_________________
'Dieselben Naturkräfte, die uns ermöglichen, zu den Sternen zu fliegen, versetzen uns auch in die Lage, unseren Stern zu vernichten.' - Wernher von Braun
http://www.mpsna.de
Back to top
View user's profile Send private message
Slurm
n00b
n00b


Joined: 30 Jul 2004
Posts: 36

PostPosted: Wed Feb 09, 2005 12:24 pm    Post subject: Reply with quote

Gut mit man krieg ich die manpages zu den Programmen und mit info die Einträge aus /usr/share/info. Aber was ist mit dem Rest an Dokumentation?

Und lässt sich das nicht nach Programmen zusammenfassen? Vielleicht sogar mit einer Übersicht über die komplette Dokumentation?
Back to top
View user's profile Send private message
hug0
Guru
Guru


Joined: 02 Mar 2004
Posts: 303

PostPosted: Wed Feb 09, 2005 1:47 pm    Post subject: Reply with quote

ich weiss nicht, ob es das ist, was du suchst, aber eine schöne sache ist im konqueror "man:foo" einzugeben
Back to top
View user's profile Send private message
Slurm
n00b
n00b


Joined: 30 Jul 2004
Posts: 36

PostPosted: Wed Feb 09, 2005 1:52 pm    Post subject: Reply with quote

Das gefällt mir sehr gut, geht auch mit info:

Aber trotzdem liegt noch viel Doku brach, die man mühselig zusammensuchen (und zum Teil entpacken) muss. Und genau dafür fehlt mir noch was.
Back to top
View user's profile Send private message
Ragin
l33t
l33t


Joined: 14 Apr 2003
Posts: 776

PostPosted: Wed Feb 09, 2005 2:15 pm    Post subject: Reply with quote

http://www.google.de

Problem ist, dass dir die ganzen Dokus auf einen Blick auch nicht viel nutzen. Du brauchst ja meist nur eine Dokumentation für ein Programm und nie alle Dokumentationen um ein Programm zu konfigurieren.

Wenn du anhand der Dokus lernen willst, dann schau dir lieber Seiten wie
http://www.selflinux.org
http://www.linuxfibel.de
http://www.pro-linux.de
an, denn dort findest du auch HowTos und Tutorials.
Das, was du in der Doku liest hast du eh zu 80% wieder vergessen, wenn du die Doku schließt, wenn du es nicht anwendest.
_________________
"Innerhalb der Computergemeinschaft lebt man nach der Grundregel, die Gegenwart sei ein Programmfehler, der in der nächsten Ausgabe behoben sein wird."

Clifford Stoll, amerik. Astrophysiker u. Computer- Pionier
Back to top
View user's profile Send private message
b3cks
Veteran
Veteran


Joined: 23 Mar 2004
Posts: 1481
Location: Bremen (GER)

PostPosted: Wed Feb 09, 2005 2:17 pm    Post subject: Reply with quote

man2html gibt es noch.
Dann haste das als schönes HTML Doc. Kann man auch super ausdrucken.
ansonsten weiß ich nicht, was du möchtest und wie Ragin schon sagte machen alle Dokus auf einem Haufen keinen Sinn. Mal abgesehen davon, dass es unmengen an Text wäre.
_________________
I am /root and if you see me laughing you better have a backup.
Back to top
View user's profile Send private message
kleinerfreak
n00b
n00b


Joined: 28 Jan 2005
Posts: 33
Location: Hessen/Germany

PostPosted: Wed Feb 09, 2005 2:24 pm    Post subject: Reply with quote

Meinst du die Dokus wie z.B. /usr/doc/kover-2.9.6/README.gz ?

Die kannst du meistens ganz einfach mit nem Editor deiner Wahl lesen... Ob´s dort die gewünschte Doku gibt, bekommst du doch mit
Code:
ls /usr/doc | grep <programm>
recht einfach raus... und das entpacken sollte auch ganz einfach gehen:
Code:
unzip README.gz

Allerdings heißen manche readmes auch nur .gz und sind ganz normaler Plaintext...

Man könnte dazu jetzt ein Frontend schreiben, ging sogar recht einfach, aber die Frage ist, ob´s das bringt... du musst ja bloß in den Ordner schauen ;)

MfG
kleinerfreak
Back to top
View user's profile Send private message
WiredEd
Apprentice
Apprentice


Joined: 11 Sep 2002
Posts: 171
Location: Bochum, Germany

PostPosted: Wed Feb 09, 2005 3:48 pm    Post subject: Reply with quote

Um .gz gezippte Dateien zu lesen bietet sich immer noch less an. Es entpackt diese schliesslich automatisch.
_________________
Athlon64 X2 4400+ EE, 2x1024MB, ASUS M2N-MX SE+
Back to top
View user's profile Send private message
Slurm
n00b
n00b


Joined: 30 Jul 2004
Posts: 36

PostPosted: Wed Feb 09, 2005 3:53 pm    Post subject: Reply with quote

Danke für die vielen Tipps, das war jetzt wirklich hilfreich.

Das heißt aber auch, dass ihr die die ganzen docs über die Konsole anschaut (sofern ihr sie anschaut) und es keinen Frontend gibt, der das alles zusammenfasst. Eine Suche zu dem Thema gestaltet sich leider sehr schwierig, da die Suchbegriffe zu allgemein sind und zu keinem vernünftigen Ergebnis führen.
Back to top
View user's profile Send private message
beejay
Retired Dev
Retired Dev


Joined: 03 Oct 2002
Posts: 924
Location: Flensungen (das liegt neben Merlau)

PostPosted: Wed Feb 09, 2005 4:03 pm    Post subject: Reply with quote

Mit ht://dig eine Suchlösung für /usr/share/docs/ erstellen und über den Index dann mit einem lokalen Apache zugreifen? So wie SuSE das mal vor Jahren hatte?
_________________
Dort wo schwarzer Rauch aufsteigt, sich alsbald ein Fehler zeigt.
www.paludis-sucks.org | www.gentoo.de | www.gentoo-ev.org | www.gentoo.org
Back to top
View user's profile Send private message
Slurm
n00b
n00b


Joined: 30 Jul 2004
Posts: 36

PostPosted: Wed Feb 09, 2005 4:29 pm    Post subject: Reply with quote

Das bringt die Diskussion jetzt in eine neue, interessante Richtung, denn schließlich könnte ich ja jede Suchmöglichkeit wie z.B. locate, find oder auch Beagle nehmen, um die entsprechenden Ordner (oder gleich das vollständige Verzeichnis des Rechners) zu indizieren und entsprechend aufbereitet zu präsentieren.

Auch wenn dann die Dokumente nur mehr ein Teil des Ergebnisses wären, gefällt mir die Idee sehr gut und ich werd mich mal diesbezüglich schlau machen.
Back to top
View user's profile Send private message
kleinerfreak
n00b
n00b


Joined: 28 Jan 2005
Posts: 33
Location: Hessen/Germany

PostPosted: Wed Feb 09, 2005 4:35 pm    Post subject: Reply with quote

es reicht IMHO aus, einfach nur /usr/share/docs zu nehmen, da man auf den Rest (manpages etc.) ja mit den entsprechenden Programmen zugreifen kann...
Back to top
View user's profile Send private message
Slurm
n00b
n00b


Joined: 30 Jul 2004
Posts: 36

PostPosted: Wed Feb 09, 2005 4:44 pm    Post subject: Reply with quote

Da war ich mir ja auch nicht so sicher, ob da nicht noch woanders versteckt Docs rumliegen.
Back to top
View user's profile Send private message
kleinerfreak
n00b
n00b


Joined: 28 Jan 2005
Posts: 33
Location: Hessen/Germany

PostPosted: Wed Feb 09, 2005 5:28 pm    Post subject: Reply with quote

Hmm, also jedes Programm, das will, dass man die Doku liest, wird entweder was für info oder man bereithalten oder wenigstens was in /usr/share/docs ablegen...
Back to top
View user's profile Send private message
Slurm
n00b
n00b


Joined: 30 Jul 2004
Posts: 36

PostPosted: Wed Feb 09, 2005 6:25 pm    Post subject: Reply with quote

Schon, aber KDE machts ja auch anders, und wer weiss, welche Programme da noch ihre eigenen Regeln haben...
Back to top
View user's profile Send private message
c07
Veteran
Veteran


Joined: 25 Oct 2002
Posts: 1091

PostPosted: Wed Feb 09, 2005 8:10 pm    Post subject: Reply with quote

kleinerfreak wrote:
Code:
unzip README.gz

Da würd ich sehr davon abraten, weil du damit die Dateien bei einem Update oder Unmerge nicht mehr automatisch loswirst. Besser ist es, jeweils
Code:
zcat README.gz | ...
zu verwenden, oder was, was gepackte Dateien direkt lesen kann (wie less).

Relativ praktisch ist es auch, /usr/share/doc lokal in einem HTTP-Server zugänglich zu machen. Das Apache-Ebuild hat das IIRC selber so eingerichtet, dass ich im Browser einfach http://localhost/doc/ aufrufen kann. Damit sind die gepackten Dateien auch kein Problem mehr.

Leider ist das Verzeichnis sehr unübersichtlich. Da wär eine Hierarchie wie im Portagebaum besser (ebenso in /usr/share). Könnte man aber relativ problemlos parallel mit Symlinks einrichten (die auf die jeweils aktuelle Version zeigen, damit man sie bookmarken kann) oder per CGI, wenn man sich das Updaten nach jedem Emerge sparen will.
Back to top
View user's profile Send private message
platinumviper
l33t
l33t


Joined: 12 Feb 2004
Posts: 661
Location: Munich, Germany

PostPosted: Wed Feb 09, 2005 10:59 pm    Post subject: Reply with quote

c07 wrote:
kleinerfreak wrote:
Code:
unzip README.gz

Da würd ich sehr davon abraten, weil du damit die Dateien bei einem Update oder Unmerge nicht mehr automatisch loswirst. Besser ist es, jeweils
Code:
zcat README.gz | ...
zu verwenden, oder was, was gepackte Dateien direkt lesen kann (wie less).

Oder vim bzw gvim, die haben auch keine Probleme mit komprimierten Dateien.

platinumviper
_________________
No money back garantee. In case of problems, don't call us, we call you.
Back to top
View user's profile Send private message
chrib
Guru
Guru


Joined: 27 Sep 2003
Posts: 558
Location: Berlin, Germany

PostPosted: Thu Feb 10, 2005 6:13 am    Post subject: Reply with quote

Wer man manpages etwas komfortabler lesen will, der sollte man einen Blick auf diesen Thread werfen. Und um sich komfortabel durch die info-Seiten von Paketen zu wühlen, dem würde ich mal ein Blick auf pinfo empfehlen.
_________________
Der Mensch kämpft um zu überleben, und nicht, um zu Grunde zu gehen. - Paulo Coelho
It is the end of all hope. To lose the child, the faith. To end all the innocence. To be someone like me. - Nightwish - End of all hope
Back to top
View user's profile Send private message
toskala
Advocate
Advocate


Joined: 14 Dec 2002
Posts: 2080
Location: hamburg, germany

PostPosted: Thu Feb 10, 2005 1:52 pm    Post subject: Reply with quote

ich weiss ja nicht... aber es gibt auch den befehl "zless"... und "bzless"...
_________________
adopt an unanswered post
erst denken, dann posten
Back to top
View user's profile Send private message
Display posts from previous:   
Reply to topic    Gentoo Forums Forum Index Deutsches Forum (German) All times are GMT
Page 1 of 1

 
Jump to:  
You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot vote in polls in this forum