Hallo Liste, wie erzeuge ich eine Manpage? Googlen brachte bisher nur die Erkenntnis, daß offenbar eine SGML-formatierte Vorlage notwendig ist. (?) Aber was ist SGML? Wie erzeuge ich sowas? Ralph -- GMX - Die Kommunikationsplattform im Internet. http://www.gmx.net
Am Don, 2002-04-18 um 09.44 schrieb Ralph Mueller:
Hallo Liste,
wie erzeuge ich eine Manpage? In diesem Fall wirklich angebracht: man man und den Querverweisen auf andere Manpages folgen.
Googlen brachte bisher nur die Erkenntnis, daß offenbar eine SGML-formatierte Vorlage notwendig ist. (?) Nein, Man-pages sind im troff-Format geschrieben, einem der ältesten Textformatierungsformate überhaupt. Dekomprimier mal eine Manpage und schau sie dir an, auf Anhieb etwas kryptisch, aber lesbar. Damit wurde vor Jahren wirklich Textverarbeitung gemacht, gewissermassen der Vorläufer von TeX.
troff (-man) -Formate können aus zahlreichen anderen Formaten mit diversen Tools erzeugt werden oder aber (wird oft gemacht) direkt von Hand geschrieben. Ralf
*** Ralph Mueller (rmue@gmx.de) schrieb in suse-linux heute:
[...] wie erzeuge ich eine Manpage?
less /usr/share/man/man1/locate.1.gz; man nroff; man groff; gv \ /usr/share/doc/packages/groff/meintro.ps
Googlen brachte bisher nur die Erkenntnis, daß offenbar eine SGML-formatierte Vorlage notwendig ist. (?)
Wo steht denn _sowas_!? Es gibt SGML- und auch XML-DocBook aber das ist ein Format, dass man _auch_ in man pages konvertieren kann. In etwa genaus, wie Du Word-Dokumente auch als ASCII abspeichern kannst.
Aber was ist SGML?
"Standard Generalized Markup Language". Superset von XML.
Wie erzeuge ich sowas?
Mit dem Texteditor? MFG Henning Hucke -- Mind your own business, Mr. Spock. I'm sick of your halfbreed interference.
* Henning Hucke schrieb am 18.Apr.2002:
*** Ralph Mueller (rmue@gmx.de) schrieb in suse-linux heute:
Aber was ist SGML?
"Standard Generalized Markup Language". Superset von XML.
Sicher? Nicht ehr Subset? Bernd -- Umsteiger von Microsoft Windows xx? Hast Du schon file://usr/doc/howto/de/DE-DOS-nach-Linux-HOWTO.txt gelesen? Auch file://usr/doc/Books/Linuxhandbuch.dvi ist zu empfehlen. |Zufallssignatur 1
On Thu, 2002-04-18 at 11:54, Bernd Brodesser wrote:
* Henning Hucke schrieb am 18.Apr.2002:
*** Ralph Mueller (rmue@gmx.de) schrieb in suse-linux heute:
Aber was ist SGML?
"Standard Generalized Markup Language". Superset von XML.
Sicher? Nicht ehr Subset?
Ganz sicher. Ist auch ungefähr 15 Jahre älter. Nagelt mich nicht auf die Zahl fest ist nur eine Größenordnung. V. -- Volker Kroll 4mino AG Chief System Developer Chausseestr. 52 b volker.kroll@4mino.de D-10115 Berlin Tel.: +49-30-2888490-0 Fax.: +49-30-2888490-99
Hallo, On Thu, 18 Apr 2002, Volker Kroll wrote:
Ganz sicher. Ist auch ungefähr 15 Jahre älter. Nagelt mich nicht auf die Zahl fest ist nur eine Größenordnung.
Eher aelter... 20 oder so... ;) HTML ist ja IIRC 1991 entstanden, und da hatte SGML schon _einige_ Jahre auf dem Buckel. -dnh -- 133: Linux Das Windows98 unter den Unixen. (Heiko Schlichting)
Bernd Brodesser wrote:
* Henning Hucke schrieb am 18.Apr.2002:
*** Ralph Mueller (rmue@gmx.de) schrieb in suse-linux heute:
Aber was ist SGML?
"Standard Generalized Markup Language". Superset von XML.
Sicher? Nicht ehr Subset?
Ja, ein superset, da XML nur einen kleinen Teilbereich von SGML darstellt. Gruß Thorsten
* Ralph Mueller schrieb am 18.Apr.2002:
wie erzeuge ich eine Manpage?
Googlen brachte bisher nur die Erkenntnis, daß offenbar eine SGML-formatierte Vorlage notwendig ist. (?)
Nicht unbedingt. manpages erzeugt man mit nroff. Siehe hierzu auch man nroff und auch man troff und man groff. nroff ist eine Formatiersprache. So zimmlich das älteste unter UNIX. Aber frag mich nichts genaueres dazu. ;)
Aber was ist SGML? Wie erzeuge ich sowas?
SGML wird wahrscheinlich das Gescheitere sein. Allerdings kann man damit nicht alles machen. Wie man das erzeugt? Mit einem Editor. ;) Schau mal in der /usr/share/doc/packages/ dort müßte es eine Dokumentation darüber geben. Weiß jetzt leider nicht wie das Paket heißt, da nicht installiert. Bernd -- Hast Du bei Problemen schon in der SuSE-Support-Datenbank (SDB) nachgesehen? Auf Deinem Rechner: http://localhost/doc/sdb/de/html/index.html | mit Apache: http://localhost/doc/sdb/de/html/key_form.html | Zufalls- Tagesaktuell bei SuSE: http://sdb.suse.de/sdb/de/html/index.html | signatur 2
On Thu, 2002-04-18 at 09:44, Ralph Mueller wrote:
wie erzeuge ich eine Manpage?
Ich mag troff nicht so richtig (habe mich noch nie so richtig damit beschäftigt). Ich schreibe meine man-pages mit POD, das ist das Hilfeformat von Perl. Danach ein pod2man und schon hat man eine echte Manpage. Das Format von POD ist auch sehr angenehm zu lesen und zu schreiben. man perlpod erklärt alles weitere HTH Volker -- Volker Kroll 4mino AG Chief System Developer Chausseestr. 52 b volker.kroll@4mino.de D-10115 Berlin Tel.: +49-30-2888490-0 Fax.: +49-30-2888490-99
#>> wie erzeuge ich eine Manpage? Ich benutze dafuer doxygen (www.doxygen.org) Regards, Sascha
Hallo, On Thu, 18 Apr 2002, Ralph Mueller wrote:
wie erzeuge ich eine Manpage?
Einfach schreiben. :) Siehe 'man [gtn]roff'. Beispiele solltest du auf deinem Rechner zu genuege finden :) Es ist ein "Auszeichnungsformat"... z.B. .TH SYNOPSIS
Googlen brachte bisher nur die Erkenntnis, daß offenbar eine SGML-formatierte Vorlage notwendig ist. (?)
Nein. Kann man. Muss man aber nicht. Auch aus texinfo kann man mittels texi2roff manpages erzeugen. Oder oder.
Aber was ist SGML? Wie erzeuge ich sowas?
"Standard(?) Generalized Markup Language". Der Vorgaenger von HTML und XML. Wird u.a. auch verwendet um die HOWTOs (mit linuxdoc) u.a. zu erzeugen. -dnh -- Außerdem ist Adrians Spruch ja auch harmlos gegen den "Tip", meine Schwestern sollten bloß niemanden heiraten, der "von Hinten" heißt, und dann einen Doppelnamen annehmen. -- Dirk Nimmich in dasr
On Thu, 18 Apr 2002 13:16:14 +0200, David Haller wrote:
Hallo,
On Thu, 18 Apr 2002, Ralph Mueller wrote:
wie erzeuge ich eine Manpage?
Einfach schreiben. :) Siehe 'man [gtn]roff'. Beispiele solltest du auf deinem Rechner zu genuege finden :)
Es ist ein "Auszeichnungsformat"... z.B.
.TH SYNOPSIS
Googlen brachte bisher nur die Erkenntnis, daß offenbar eine SGML-formatierte Vorlage notwendig ist. (?)
Nein. Kann man. Muss man aber nicht. Auch aus texinfo kann man mittels texi2roff manpages erzeugen. Oder oder.
Aber was ist SGML? Wie erzeuge ich sowas?
"Standard(?) Generalized Markup Language". Der Vorgaenger von HTML und XML. Wird u.a. auch verwendet um die HOWTOs (mit linuxdoc) u.a. zu erzeugen.
Der Vorgänger ist wohl ein bischen zu kurz gegriffen und wird SGML nicht gerecht. HTML und auch XML sind Subsets ( Untermengen) von SGML. Und ob die Ursprungsquelltexte die für man Seiten und andere Dokumetation echtes SGML sind , besser zueinander kompatibel, wage ich zu bezweifeln. Beispielsweise sind XML von Koffice und Openoffice zwei verschiedene Dinge. Und soweit ich das weiß unterscheinden sich sogar SGML von Linox Howto Project US und vom Linux Howto Projekt DE. It's time to close windows !!! with best regards from Dortmund Matthias Popp 49-163-4289 455 PGP Public Key Fingerprint = 71 13 E9 4B 89 E5 88 6C 66 1D B8 E8 32 3A AE AB
* Matthias Popp schrieb am 18.Apr.2002:
Der Vorgänger ist wohl ein bischen zu kurz gegriffen und wird SGML nicht gerecht. HTML und auch XML sind Subsets ( Untermengen) von SGML. Und ob die Ursprungsquelltexte die für man Seiten und andere Dokumetation echtes SGML sind , besser zueinander kompatibel, wage ich zu bezweifeln. Beispielsweise sind XML von Koffice und Openoffice zwei verschiedene Dinge. Und soweit ich das weiß unterscheinden sich sogar SGML von Linox Howto Project US und vom Linux Howto Projekt DE.
Also entweder ich habe da was zimmlich flasch verstanden, oder ich weiß auch nicht. Soviel ich weiß, kann SGML noch nicht mal Tabellen, wie kann es da eine Übermenge von HTML sein? Bernd -- ROTFL = Rolling On The Floor, Laughing = Auf dem Boden wälzen, lachend. SCNR = Sorry, Could Not Resist = Sorry, Ich konte nicht wiederstehen. AFAIK = As Far As I Know = So weit ich weis|BTW = By The Way = Nebenbei bemerkt IMHO = In My Humble Opinion = meiner bescheidenen Meinung nach |Zufallssig. 9
On Thu, 18 Apr 2002, Bernd Brodesser wrote:
* Matthias Popp schrieb am 18.Apr.2002: [... SGML Superset von XML und HTML ...] Also entweder ich habe da was zimmlich flasch verstanden, oder ich weiß auch nicht. Soviel ich weiß, kann SGML noch nicht mal Tabellen, wie kann es da eine Übermenge von HTML sein?
Du wirfst Auszeichnugssprachen und renderer durcheinander. Quiz-Frage: Was sollen wohl die DTD-Angaben im Kopf diverser HTML-Seiten!? Sind die zum essen da? Wenn ja, wer wird sie wohl essen!? <Seufz/> MG Henning Hucke -- How many bits would a BitBlit blit if a BitBlit could blit bits? -- macanespie@waves.pas.ti.com in <1993Nov16.130625.1@waves.pas.ti.com>
On Thu, 18 Apr 2002 21:53:59 +0200 (CEST), Henning Hucke wrote:
On Thu, 18 Apr 2002, Bernd Brodesser wrote:
* Matthias Popp schrieb am 18.Apr.2002: [... SGML Superset von XML und HTML ...] Also entweder ich habe da was zimmlich flasch verstanden, oder ich weiß auch nicht. Soviel ich weiß, kann SGML noch nicht mal Tabellen, wie kann es da eine Übermenge von HTML sein?
Du wirfst Auszeichnugssprachen und renderer durcheinander.
Quiz-Frage: Was sollen wohl die DTD-Angaben im Kopf diverser HTML-Seiten!? Sind die zum essen da? Wenn ja, wer wird sie wohl essen!?
Den Browser möcht ich sehen der sich darum kümmert. Die DTD-Angabe kann man auch weglassen.
<Seufz/>
Dann würde ich mal das w3c besuchen. SGML = Standard General Markup Language SGML ist eine Metasprache für die Beschreibung von Markupsprachen. HTML ist eine solche. HTML gleich HyperText Markup Language. PS: HTML ist ein SGML Anwendung und es gibt für jede HTML Version einen Dokumententaypedefinition (DTD) PPS: Kann man beim W3C bekommen Aus einem Geschichtsbuch aus dem Jahre 2010 ueber Microsoft: "..denn sie versuchten Ihre Software als Betriebssystem zu verkaufen!" PGP Public Key Fingerprint = 71 13 E9 4B 89 E5 88 6C 66 1D B8 E8 32 3A AE AB
Hallo, Am 18.04.02 schrieb Bernd Brodesser:
weiß auch nicht. Soviel ich weiß, kann SGML noch nicht mal Tabellen, wie kann es da eine Übermenge von HTML sein?
XML kennt auch keine Tabellen. SGML dürfte, wie auch XML, ausschließlich die Syntax beschreiben und nicht die Semantik. HTML beschreibt jedoch die Semantik (z.B. Tabellen). Daniel
Hallo, On Thu, 18 Apr 2002, Bernd Brodesser wrote:
Also entweder ich habe da was zimmlich flasch verstanden, oder ich weiß auch nicht. Soviel ich weiß, kann SGML noch nicht mal Tabellen, wie kann es da eine Übermenge von HTML sein?
RTFSource, Luke^WBernd! $ ls -lR /usr/share/sgml/html* $ less /usr/share/sgml/html*/* HTML _ist_ eine SGML Anwendung... So wie docbook und linuxdoc... Sind alles nur verschiedene DTDs... -d'*scnr*'nh -- Ich friere weil ich schwitze.. In dieser kalten Hitze. Vor lauter Hunger bin Ich satt. Und alle Berge werden platt. [WoKo in dafb]
Hallo, On Thu, 18 Apr 2002, Matthias Popp wrote:
On Thu, 18 Apr 2002 13:16:14 +0200, David Haller wrote:
On Thu, 18 Apr 2002, Ralph Mueller wrote: [..]
Aber was ist SGML? Wie erzeuge ich sowas?
"Standard(?) Generalized Markup Language". Der Vorgaenger von HTML und XML. Wird u.a. auch verwendet um die HOWTOs (mit linuxdoc) u.a. zu erzeugen.
Der Vorgänger ist wohl ein bischen zu kurz gegriffen und wird SGML nicht gerecht.
Hm, ok, sagen wir Vorlaeufer ;)
HTML und auch XML sind Subsets ( Untermengen) von SGML. Und ob die Ursprungsquelltexte die für man Seiten und andere Dokumetation echtes SGML sind , besser zueinander kompatibel, wage ich zu bezweifeln.
Sind sie! Siehe auch 'man nsgmls' (ein validierender sgml-parser).
Beispielsweise sind XML von Koffice und Openoffice zwei verschiedene Dinge. Und soweit ich das weiß unterscheinden sich sogar SGML von Linox Howto Project US und vom Linux Howto Projekt DE.
Nein. Was sich unterscheidet, sind die "Document Type Definitions" (DTD). Siehe /usr/share/sgml/*. Auch die HTML Versionen unterscheiden sich (ausschliesslich) in ihren DTDs. HTML ist ein "echtes" Subset von SGML, insofern, da HTML durch eine DTD definiert wird. XML 1.0 wird auch durch eine DTD definiert, seit "kurzem" kann der "Document Type" aber auch mit XML Mitteln definiert werden (Bezeichnung ist mir grad entfallen, XPath ist's IIRC nicht ;) HTML, docbook, linuxdoc u.a. sind also alles SGML Anwendungen. -dnh -- 110: Leben und Sterben in UNIX -- kill ist ein gut zielendes Gewehr. killproc eine Schrotflinte. killall eine 10kg-Handgranate. Wenn das Programm zum Teil herausgeswappt ist, fängt es besonders ungezielt um sich zu schlagen. (Siehe dazu -e.) Häufig geht es gut. Manchmal erwischt man auch etwas zu viel. (Frank Klemm)
[Antworten von David, Matthias, Bertram, Henning, Sascha, Bernd, Ralf und Daniel auf meine Frage] Vielen Dank an alle. Ralph
Hallo, Am Donnerstag, 18. April 2002 09:44 schrieb Ralph Mueller:
wie erzeuge ich eine Manpage?
Ein schönes Beispiel steht in
http://www.oreilly.de/german/freebooks/rlinux3ger/ch094.html#70194
(Das Beispielprogramm kommt auf dem Konqueror-Browser
schlecht raus; Das ganze Programm steht in einer Zeile.
Leserlicher ist es unter "Quelltext anzeigen".)
Suche nach "Kaffe".
Gruß
Bertram
--
Bertram Scharpf
participants (12)
-
B.Brodesser＠t-online.de -
Bertram Scharpf -
Daniel Seuthe -
David Haller -
Henning Hucke -
Matthias Popp -
Ralf Corsepius -
Ralph Mueller -
Ralph Müller
-
Sascha Presnac -
Thorsten Strusch -
Volker Kroll