Schlagwort-Archive: dokumentation

Was ist RFC (Request for Comments)?

Ein RFC (Request for Comments: Bitte um Kommentare) ist ein Dokument, das organisatorische oder technische Zusammenhänge beschreibt, und sich über Status bis hin zum akzeptierten Internetstandard entwickeln kann. Die genutzten Status sind:

  • Informational: Hinweis, Idee, Nutzung, Mitteilung an die Netzgemeinde
  • Experimental: Experimentell, Anfangsstadium eines potenziellen Standards
  • Proposed : Vorschlag für
  • Draft Standard: Begutachtung von Implementierungen
  • Standard: offizieller Standard STD
  • Historic (auch obsolete): abgelöste RFC oder STD

Die Dokumente werden bei rfc-editor.org veröffentlicht und zeichnen sich durch Genauigkeit und Formalismus aus, was mit der Festlegung der genauen Bedeutung von Worten und Formulierungen beginnt und eine vollständige beinhaltet.

Dies ermöglicht die bei Verfahren und Protokollen notwendige klare und eindeutige Festlegung.

RFC behalten stets ihren Namen und Nummer. Ein veröffentlichter RFC wird nicht geändert, kann jedoch durch weitere RFC mit eigener Nummer ergänzt oder abgelöst werden.

Der erste RFC wurde von Steve Crocker geschrieben und am 07.04.1969 veröffentlicht. Weiterlesen

Veröffentlicht unter Internet | Verschlagwortet mit , | Hinterlasse einen Kommentar

Was ist eine Man-Page?

Eine Man-Page ist eine Hilfe- oder Dokumentationsseite, die mit dem Kommando man auf Unix-verwandten Betriebssystemen angezeigt wird.

Der  Unterschied zu den Kurzdokumentationen von Programmen beim Aufruf ohne Parameter ist, dass die weit umfangreicher und genauer sein kann.

Zudem ist sie nicht darauf beschränkt, nur ausführbare Programme zu dokumentieren.

Alle diese Seiten zusammen werden Man-Pages genannt und sind oft im Verzeichnis /usr/share/man abgelegt, wobei der Ort frei ist und auch mehrere Sammlungen von Dokumentationen möglich sind. Der bevorzugte Pfad kann in der Umgebungsvariable MANPATH hinterlegt werden.

Der Aufruf

man name

ruft die Dokumentation von name ab und stellt sie dar. (more…)

Veröffentlicht unter Computer | Verschlagwortet mit | Hinterlasse einen Kommentar