Ja, das stimmt schon. Allerdings wird dieser Mangel wiederum dadurch etwas ausgeglichen, dass man pages normalerweise einer bestimmten Struktur folgen. Wenn ich beispielsweise wissen will, welche Dateien für die Konfiguration eines Programms relevant sind, finde ich die Antwort zumeist im Abschnitt FILES (bzw. DATEIEN in deutschsprachigen Varianten). Da die Überschriften der Abschnitte in Großbuchstaben geschrieben sind, lassen die sich auch recht einfach finden.
Von Produktiv-Benutzer am So, 24. März 2019 um 16:37 #
normalerweise Diesen Gedankengang hatte ich beim Verfassen meines ersten Beitrags in dieser Umfrage.
Daraus ergab sich die Idee, nach einem Werkzeug, das automatisiert die man-pages im System darauf überprüft, ob sie "Standard-Sektionen" liefern und ob insbesondere eine Beispiel-Sektion vorhanden ist.
Das könnte man z.B. auch selbst als Entwickler nutzen, ins makefile integriert, würde so die Dokumentation automatisch überprüft.
Dies nur als oberflächlicher Test. Weiter könnte man man-pages (wenn durch selbe unterstützt) darauf abklopfen, automatisiert aus dem angegebenen Befehl Beispiele zu erzeugen. (so wie ungefähr wie make dependend). Oder man könnte man-pages automatische splitten, in Einsteiger / Fortgeschrittene / "Schnellgucker"
Die Idee biete viele Ansätze für drastische Qualitätsverbesserungen.
Vielleicht gibt's ja bereits Programme, die mir nicht bekannt sind ??
Ja, das stimmt schon. Allerdings wird dieser Mangel wiederum dadurch etwas ausgeglichen, dass man pages normalerweise einer bestimmten Struktur folgen. Wenn ich beispielsweise wissen will, welche Dateien für die Konfiguration eines Programms relevant sind, finde ich die Antwort zumeist im Abschnitt FILES (bzw. DATEIEN in deutschsprachigen Varianten). Da die Überschriften der Abschnitte in Großbuchstaben geschrieben sind, lassen die sich auch recht einfach finden.
normalerweise Diesen Gedankengang hatte ich beim Verfassen meines ersten Beitrags in dieser Umfrage.
Daraus ergab sich die Idee, nach einem Werkzeug, das automatisiert die man-pages im System darauf überprüft,
ob sie "Standard-Sektionen" liefern und ob insbesondere eine Beispiel-Sektion vorhanden ist.
Das könnte man z.B. auch selbst als Entwickler nutzen, ins makefile integriert, würde so die Dokumentation automatisch überprüft.
Dies nur als oberflächlicher Test. Weiter könnte man man-pages (wenn durch selbe unterstützt) darauf abklopfen, automatisiert aus dem angegebenen Befehl Beispiele zu erzeugen. (so wie ungefähr wie make dependend). Oder man könnte man-pages automatische splitten, in Einsteiger / Fortgeschrittene / "Schnellgucker"
Die Idee biete viele Ansätze für drastische Qualitätsverbesserungen.
Vielleicht gibt's ja bereits Programme, die mir nicht bekannt sind ??