Firebirdforum.de

Hallo.

Es gibt ja nun verschiedene Umgebungen in denen (fast) gleichnamige Tools vorzufinden sind (z. B. Interavtice SQL (dbisql) bei Anyhere). Selbst in der Firebird-Dokumentation (Manual "Firebird Interactive SQL Utility") wird auf Folgendes hingewiesen: "Da andere Anwendungen in der Linux-Umgebung, z.B. mySQL, auch isql als Dienstprogrammnamen verwenden, wird empfohlen, das Firebird-Dienstprogramm aus seinem eigenen Verzeichnis auszuführen oder den absoluten Dateipfad anzugeben, wenn Sie neben Firebird eine andere relationale Datenbank auf Ihrem Computer installiert haben." (Deutsche Übersetzung in etwa.)

Ich habe in den Lizenztexten zu Firebird (Version 4.0 Beta1) und im Internet nach einen eventuell vorgegebenen Dienstprogrammnamen gesucht.

Hier meine Suchergebnisse:

1. Lizenztexte und Hilfetext auf der Festplatte: Keine Erwähnung

2. Manual: https://firebirdsql.org/manual/isql.html#isql-version

"Firebird Interactive SQL Utility" (Autoren: Kamala Vadlamani; Paul Vinkenoog; Norman Dunbar)
Der aktuelle Titel des Manuals in deutscher Übersetzung wäre demnach: Firebird Interaktives SQL Dienstprogramm

Weiter unten im Manual unter "Einführung" findet sich dann auch eine Abkürzung:
"This manual provides reference material for the Firebird Interactive SQL Utility (isql), and instructions on how to use it to perform tasks within the database."
Dieses Handbuch enthält Referenzmaterial für das Firebird Interactive SQL Dienstprogramm (isql) und ... (Deutsche Übersetzung in etwa.)

Und als das noch nicht reichen würde erscheint nach dem Ausführen der "isql.exe" das folgende Programmfenster:
Wie also beziehen wir uns bei der Schreibweise exakt(er) auf "Firebird Interaktives SQL Dienstprogramm"?
Hat jemand sogar eine von 'Firebird.org' dafür festgelegte abkürzende Schreibregel parat?
Welche Schreibweise hat sich diesbezüglich über die Jahre durchgesetzt - wird an anderer Stelle verwendet?

Klar, das hier ist das Firebird.de-Forum. Nur ISQL und iSQL könnten genausogut auch zwei verschiedene Dienstprogramme oder Versionen sein. Und deutsch-sprachig genau genommen könnte sich dieses Dienstprogramm auch 'Firebird Dienstprogramm für interaktives SQL' nennen lassen. Das Dienstprogramm selbst ist ja nicht interaktiv - es versetzt den Anwender in die Lage, interaktiv mit SQL zu kommunizieren.

Manual-Titel hin - Titelleisteninhalt her
Ich würde anregen, es bei Ersterwähnung ein Mal im Text so zu schreiben, wie es in der Titelleiste (aktuell) dargestellt wird. Danach kann es ja dann gekürzt werden.
Ersterwähnung: Firebird ISQL Tool
Folgeerwähnung(en): ISQL Tool oder ISQL (Von einem iSQL würde ich aus jetziger Sicht Abstand nehmen wollen - ein isql wäre da noch denkbar.)


Danke fürs Lesen und viele Grüße.
Gerd

Als ob es nicht andere Probleme gäbe....

bfuerchau hat geschrieben: ↑Sa 12. Okt 2019, 15:19 Als ob es nicht andere Probleme gäbe....

Schreibe mal für Anwender ein Software-Handbuch. Erwähne auf Seite 78 das Firebird ISQL Tool und dann auf Seite 101, dass diese Aufgabe mit iSQL erledigt werden kann.

Aber ich stimme Dir zu - 'andere Probleme', es gibt sie.


Viele Grüße
Gerd

Und wie viele Anwender hast du erlebt, die tatsächlich mal die Anleitung gelesen haben? Die Mühe wirds sich häufig geschenkt.

Hallo bfuerchau.

Erlebt nicht, aber auf Rechnung an sie verkauft. Etwa 200 Stück. Sowohl in Print- als auch elektronischer Edition. Ich gehe mal davon aus, dass derjenige, der gekauft hat, dann auch darin liest. Ich erstelle fast immer und mit großem Aufwand Hilfedateien für meine Programme. Sie folgen u. a. dem Ansatz Bezeichnung(en) dokumentweit beizubehalten.

Ich vergleiche für mich das Forum mit einem Softwarehandbuch. Je mehr sich darum bemüht wird korrekte (eindeutige) Bezeichnungen zu verwenden, desto unmissverständliche und leserfreundlicher wird es sich präsentieren. Ich fände es z. B. wünschenswert, wenn der Ersteller eines Themas lieb darauf hingewiesen wird, eine bestimmte Bezeichnung doch bitte entsprechend zu ändern. Es sollte auch keine Abkürzung in einem Thema auftreten, ohne das sie an oberer Stelle nicht einmal komplett ausgeschrieben wurde. Einem Forum fehlen in aller Regel Abkürzungs- bzw. Stichwortverzeichnis. Man muss es verlassen und woanders nachschlagen - und das könnte man sich des Öfteren sparen.
Na ja, wohl ein Kampf gegen Windmühlen.


Viele Grüße
Gerd

"Man muss es verlassen und woanders nachschlagen" ???
Die Browser, die ich kenne, unterstützen mehrere Tabs. Ich würde das mal probieren dann kannst du im Forum bleiben .

bfuerchau hat geschrieben: ↑So 13. Okt 2019, 17:30 "Man muss es verlassen und woanders nachschlagen" ???
Die Browser, die ich kenne, unterstützen mehrere Tabs. Ich würde das mal probieren dann kannst du im Forum bleiben .

Ach bfuerchau ...

Leider gibt es kein Emoticon für ": nicht ernst gemeint :"

Schreibe mal für Anwender ein Software-Handbuch. Erwähne auf Seite 78 das Firebird ISQL Tool und dann auf Seite 101, dass diese Aufgabe mit iSQL erledigt werden kann.

Aus eigener Erfahrung kann ich da nur zustimmen. Manchmal kann man in solchen Fällen nur seufzen. Aber wenn man dann mal ehrlich ist, ist diese Kritik gerechtfertigt. Beim Schreiben von Handbüchern sollte man (im besten Falle) konsequent sein.

Gruß
Martin

Was mich betrifft, so werde ich mich einfach nur bemühen, mit gutem Beispiel voranzugehen.


Viele Grüße
Gerd