FHEM Forum

FHEM => Sonstiges => Thema gestartet von: Otto123 am 26 Juli 2021, 11:20:40

Titel: Könnte man help verbessern?
Beitrag von: Otto123 am 26 Juli 2021, 11:20:40
Gestern habe ich bemerkt, dass die hier (https://forum.fhem.de/index.php/topic,13092.msg685983.html#msg685983) gezeigte Erweiterung für Modulnamen und für Dateinamen der Module funktioniert aber nicht für fhem bzw. fhem.pl (bzw. nicht für alle in der Maintainer.txt geführten Referenzen). Ich dachte, wenigsten so eine entsprechende Zeile wäre als Antwort schön:
ZitatModule: fhem.pl Maintainer: rudolfkoenig Forum: Sonstiges
Dann habe ich heute noch etwas weiterprobiert und festgestellt, dass man auch folgende Hilfetexte direkt abrufen kann (ich habe nur zur Verdeutlichung die Links auf die Onlineversion eingefügt):
help intro -> https://fhem.de/commandref_modular.html#intro
help command -> https://fhem.de/commandref_modular.html#command
help devspec -> https://fhem.de/commandref_modular.html#devspec
help attributes -> https://fhem.de/commandref_modular.html#attributes
help perl -> https://fhem.de/commandref_modular.html#perl
Warum das dann nicht geht?:
help gnuplot-syntax https://fhem.de/commandref_modular.html#gnuplot-syntax

Könnte man diesen "allgemeinen Teil" der commandref (oder die Links dahin) bei help fhem einfach mit einblenden?

Und dabei kommt mir immer wieder die Frage in den Sinn: Warum ist die Struktur der Inhaltsliste der commandref so?
Warum steht der allgemeine Abschnitt Perl Specials ganz am Ende, nach der mittlerweile ewig langen Liste an Modulen?

Introduction
FHEM command types
Device specification
Attributes
  FHEM comands ...
  ...
  Helper moduls ...
Perl specials
gnuplot file syntax

Ist das einfach historisch so gewachsen? Meiner Meinung nach wäre es besser die beiden letzen Inhaltspunkte mit nach vorn zu holen.

Grüße Otto
Titel: Antw:Könnte man help verbessern?
Beitrag von: rudolfkoenig am 26 Juli 2021, 12:20:51
ZitatWarum steht der allgemeine Abschnitt Perl Specials ganz am Ende, nach der mittlerweile ewig langen Liste an Modulen?
Historisch gewachsen. Es nach vorne zu holen ist nicht ganz einfach, weil es das erste Tag nach den Modulen ist, was mW irgendwo ausgenutzt wird, und das muesste man vorher klaeren.
Ich wuerde, wenn nicht dringend, es dabei belassen.
Titel: Antw:Könnte man help verbessern?
Beitrag von: Otto123 am 26 Juli 2021, 12:48:54
Ach was ist schon dringend ;)
Ich finde nur: es steht so sehr aus dem Blickfeld gerückt. In der (eigentlich besseren) modularen Variante fast nicht mehr findbar ...

Aber ich will nichts durcheinanderbringen :)