Skip to content

Commit

Permalink
#205 Use lowercase protocol names when referencing it in context of URLs
Browse files Browse the repository at this point in the history
  • Loading branch information
mrotteveel committed Apr 2, 2024
1 parent 5d617ea commit d08096d
Show file tree
Hide file tree
Showing 23 changed files with 118 additions and 72 deletions.
Expand Up @@ -12,20 +12,20 @@ Die originale Dokumentation wurde unter dem Titel [ref]_Firebird 3.0 Language Re
Dieses Dokument basiert auf der [ref]_Firebird 2.5 Language Reference_.

Die ursprünglichen Schreiber der Originaldokumentation sind: Paul Vinkenoog, Dmitry Yemanov, Thomas Woinke und Mark Rotteveel.
Verfasser der ursprünglichen Texte in russisch sind Denis Simonov, Dmitry Filippov, Alexander Karpeykin, Alexey Kovyazin und Dmitry Kuzmenko.
Verfasser der ursprünglichen Texte in Russisch sind Denis Simonov, Dmitry Filippov, Alexander Karpeykin, Alexey Kovyazin und Dmitry Kuzmenko.

Copyright (C) 2008-2023.
Copyright (C) 2008-2024.
Alle Rechte vorbehalten.
(Kontakt mit dem Verfasser: paul at vinkenoog dot nl.)

Verfasser und Bearbeiter des inkludierten PDL-lizenzierten Materials sind: J. Beesley, Helen Borrie, Arno Brinkman, Frank Ingermann, Vlad Khorsun, Alex Peshkov, Nickolay Samofatov, Adriano dos Santos Fernandes, Dmitry Yemanov.

Enthaltene Teile unterliegen dem Copyright (C) 2001-2023 ihrer jeweiligen Verfasser.
Enthaltene Teile unterliegen dem Copyright (C) 2001-2024 ihrer jeweiligen Verfasser.
Alle Rechte vorbehalten.

Mitwirkende: Mark Rotteveel.

Inhalte, die durch Mark Rotteveel erstellt wurden, unterliegen dem Copyright (C) 2018-2023.
Inhalte, die durch Mark Rotteveel erstellt wurden, unterliegen dem Copyright (C) 2018-2024.
Alle Rechte vorbehalten.
(Kontakt mit dem Verfasser: mrotteveel at users dot sourceforge dot net).

Expand Down
Expand Up @@ -10,7 +10,12 @@ Die exakte Dateihistorie ist im _Git_-Repository des `firebird-documentation`-Re
|===
4+|Historie

|1-13.de
|1.13.1.de
|2. April 2024
|MR
|Protokollnamen werden in Kleinbuchstaben geschrieben (https://github.com/FirebirdSQL/firebird-documentation/issues/205[#205])

|1.13.de
|30. Januar 2023
|MR
|Tippfehler im Sortierungsnamen `UCS_BASIC` behoben
Expand Down
Expand Up @@ -203,11 +203,11 @@ In dieser Syntax gibt der erste Teil den Namen des Protokolls an, dann einen Hos

Als Protokoll können folgende Werte angegeben werden:

INET:: TCP/IP (versucht zuerst eine Verbindung über das IPv6-Protokoll herzustellen, wenn dies fehlschlägt, dann IPv4)
INET4:: TCP/IP v4 (seit Firebird 3.0.1)
INET6:: TCP/IP v6 (seit Firebird 3.0.1)
WNET:: NetBEUI oder Named Pipes Protocol
XNET:: lokales Protokoll (enthält keinen Host-, Port- und Servicenamen)
inet:: TCP/IP (versucht zuerst eine Verbindung über das IPv6-Protokoll herzustellen, wenn dies fehlschlägt, dann IPv4)
inet4:: TCP/IP v4 (seit Firebird 3.0.1)
inet6:: TCP/IP v6 (seit Firebird 3.0.1)
wnet:: NetBEUI oder Named Pipes Protocol
xnet:: lokales Protokoll (enthält keinen Host-, Port- und Servicenamen)

[listing,subs=+quotes]
----
Expand Down
@@ -1,7 +1,7 @@
[[fblangref30-de]]
= Firebird 3.0 Sprachreferenz
Dmitry Filippov; Alexander Karpeykin; Alexey Kovyazin; Dmitry Kuzmenko; Denis Simonov; Paul Vinkenoog; Dmitry Yemanov; Mark Rotteveel; Martin Köditz
1.13-de, 30. Januar 2023
1.13.1-de, 4. April 2024
:doctype: book
:sectnums:
:sectanchors:
Expand All @@ -16,7 +16,7 @@ include::../../attributes-de.adoc[]
Die Quelle des meist kopierten Referenzmaterials: Paul Vinkenoog +
Weitere Quelle kopierten Referenzmaterials: Thomas Woinke +
Übersetzung ins Deutsche: Martin Köditz +
Copyright (C) 2017-2023 Das Firebird Projekt und alle beteiligten Autoren, unter der https://www.firebirdsql.org/manual/pdl.html[Public Documentation License Version 1.0].
Copyright (C) 2017-2024 Das Firebird Projekt und alle beteiligten Autoren, unter der https://www.firebirdsql.org/manual/pdl.html[Public Documentation License Version 1.0].
Bitte vergleichen Sie auch <<fblangref30-license-de,Lizenzhinweise>> im Anhang.

toc::[]
Expand Down
Expand Up @@ -12,20 +12,20 @@ Die originale Dokumentation wurde unter dem Titel [ref]_Firebird 4.0 Language Re
Dieses Dokument basiert auf der [ref]_Firebird 3.0 Language Reference_.

Die ursprünglichen Schreiber der Originaldokumentation sind: Paul Vinkenoog, Dmitry Yemanov, Thomas Woinke und Mark Rotteveel.
Verfasser der ursprünglichen Texte in russisch sind Denis Simonov, Dmitry Filippov, Alexander Karpeykin, Alexey Kovyazin und Dmitry Kuzmenko.
Verfasser der ursprünglichen Texte in Russisch sind Denis Simonov, Dmitry Filippov, Alexander Karpeykin, Alexey Kovyazin und Dmitry Kuzmenko.

Copyright (C) 2008-2023.
Copyright (C) 2008-2024.
Alle Rechte vorbehalten.
(Kontakt mit dem Verfasser: paul at vinkenoog dot nl.)

Verfasser und Bearbeiter des inkludierten PDL-lizenzierten Materials sind: J. Beesley, Helen Borrie, Arno Brinkman, Frank Ingermann, Vlad Khorsun, Alex Peshkov, Nickolay Samofatov, Adriano dos Santos Fernandes, Dmitry Yemanov.

Enthaltene Teile unterliegen dem Copyright (C) 2001-2023 ihrer jeweiligen Verfasser.
Enthaltene Teile unterliegen dem Copyright (C) 2001-2024 ihrer jeweiligen Verfasser.
Alle Rechte vorbehalten.

Mitwirkende: Mark Rotteveel.

Inhalte, die durch Mark Rotteveel erstellt wurden, unterliegen dem Copyright (C) 2018-2023.
Inhalte, die durch Mark Rotteveel erstellt wurden, unterliegen dem Copyright (C) 2018-2024.
Alle Rechte vorbehalten.
(Kontakt mit dem Verfasser: mrotteveel at users dot sourceforge dot net).

Expand Down
Expand Up @@ -10,6 +10,11 @@ Die exakte Dateihistorie ist im _Git_-Repository des `firebird-documentation`-Re
|===
4+|Historie

|2.3.1.de
|2. April 2024
|MR
|Protokollnamen werden in Kleinbuchstaben geschrieben (https://github.com/FirebirdSQL/firebird-documentation/issues/205[#205])

|2.3-de
|30. Januar 2023
|MR
Expand Down
Expand Up @@ -203,11 +203,11 @@ In dieser Syntax gibt der erste Teil den Namen des Protokolls an, dann einen Hos

Als Protokoll können folgende Werte angegeben werden:

INET:: TCP/IP (versucht zuerst eine Verbindung über das IPv6-Protokoll herzustellen, wenn dies fehlschlägt, dann IPv4)
INET4:: TCP/IP v4
INET6:: TCP/IP v6
WNET:: NetBEUI oder Named Pipes Protocol
XNET:: lokales Protokoll (enthält keinen Host-, Port- und Servicenamen)
inet:: TCP/IP (versucht zuerst eine Verbindung über das IPv6-Protokoll herzustellen, wenn dies fehlschlägt, dann IPv4)
inet4:: TCP/IP v4
inet6:: TCP/IP v6
wnet:: NetBEUI oder Named Pipes Protocol
xnet:: lokales Protokoll (enthält keinen Host-, Port- und Servicenamen)

[listing,subs=+quotes]
----
Expand Down
@@ -1,7 +1,7 @@
[[fblangref40-de]]
= Firebird 4.0 Sprachreferenz
Dmitry Filippov; Alexander Karpeykin; Alexey Kovyazin; Dmitry Kuzmenko; Denis Simonov; Paul Vinkenoog; Dmitry Yemanov; Mark Rotteveel; Martin Köditz
2.3-de, 30. Januar 2023
2.3.1-de, 4. April 2024
:doctype: book
:sectnums:
:sectanchors:
Expand All @@ -16,7 +16,7 @@ include::../../attributes-de.adoc[]
Die Quelle des meist kopierten Referenzmaterials: Paul Vinkenoog +
Weitere Quelle kopierten Referenzmaterials: Thomas Woinke +
Übersetzung ins Deutsche: Martin Köditz
Copyright (C) 2017-2023 Das Firebird Projekt und alle beteiligten Autoren, unter der https://www.firebirdsql.org/manual/pdl.html[Public Documentation License Version 1.0].
Copyright (C) 2017-2024 Das Firebird Projekt und alle beteiligten Autoren, unter der https://www.firebirdsql.org/manual/pdl.html[Public Documentation License Version 1.0].
Bitte vergleichen Sie auch <<fblangref40-license-de,Lizenzhinweise>> im Anhang.

[TIP]
Expand Down
19 changes: 12 additions & 7 deletions src/docs/asciidoc/en/firebirddocs/gbak/firebird-gbak.adoc
@@ -1,7 +1,7 @@
[[gbak]]
= Firebird's gbak Backup and Restore Utility
Norman Dunbar; Mark Rotteveel
1.16, 24 February 2024
1.17, 2 April 2024
:doctype: book
:sectnums:
:sectanchors:
Expand Down Expand Up @@ -1522,11 +1522,11 @@ Firebird 3.0 and higher connection strings:
[listing]
----
# TCP/IP (v4 and v6)
INET://[<hostname>[:<port]]/service_mgr
inet://[<hostname>[:<port]]/service_mgr
# TCP/IP (v4 only)
INET4://[<hostname>[:<port]]/service_mgr
inet4://[<hostname>[:<port]]/service_mgr
# TCP/IP (v6 only)
INET6://[<hostname>[:<port]]/service_mgr
inet6://[<hostname>[:<port]]/service_mgr
----
+
If port is not specified, port `3050` is used.
Expand All @@ -1543,7 +1543,7 @@ XNET is only supported on Windows.

Named pipes/WNET::
Legacy connection string: `\\<hostname>[@<port>]\service_mgr` +
Firebird 3.0 and 4.0 connection string: `WNET://[<hostname>[:<port>]]/service_mgr`
Firebird 3.0 and 4.0 connection string: `wnet://[<hostname>[:<port>]]/service_mgr`
+
Support for named pipes (a.k.a. WNET) was removed in Firebird 5.0, and in earlier versions only available on Windows.

Expand Down Expand Up @@ -1783,13 +1783,18 @@ The exact file history is recorded in the firebird-documentation git repository;
|===
4+|Revision History

|1.17
|2 Apr 2024
|MR
|Protocol names are lowercase (https://github.com/FirebirdSQL/firebird-documentation/issues/205[#205])

|1.16
|24 February 2024
|24 Feb 2024
|MR
|Fixed rendering issue with `-{wj}INCLUDE[_DATA]` syntax

|1.15
|24 February 2024
|24 Feb 2024
|MR
|Include `gbak` name in the document title, making it the same as on https://firebirdsql.org/en/reference-manuals/

Expand Down
23 changes: 12 additions & 11 deletions src/docs/asciidoc/en/firebirddocs/isql/firebird-isql.adoc
@@ -1,7 +1,7 @@
[[isql]]
= Firebird's isql Interactive SQL Utility
Kamala Vadlamani; Paul Vinkenoog; Norman Dunbar; Mark Rotteveel
1.2, 24 February 2024
1.3, 2 April 2024
:doctype: book
:sectnums:
:sectanchors:
Expand Down Expand Up @@ -429,11 +429,11 @@ In this syntax, the first part specifies the name of the protocol, then a host n

The following values can be specified as the protocol:

INET:: TCP/IP (first tries to connect using the IPv6 protocol, if it fails, then IPv4)
INET4:: TCP/IP v4
INET6:: TCP/IP v6
WNET:: NetBEUI or Named Pipes Protocol (removed in Firebird 5.0)
XNET:: local protocol (does not include a host, port and service name)
inet:: TCP/IP (first tries to connect using the IPv6 protocol, if it fails, then IPv4)
inet4:: TCP/IP v4
inet6:: TCP/IP v6
wnet:: NetBEUI or Named Pipes Protocol (removed in Firebird 5.0)
xnet:: local protocol (does not include a host, port and service name)

[listing,subs=+quotes]
----
Expand Down Expand Up @@ -3242,6 +3242,11 @@ The exact file history is recorded in the firebird-documentation git repository;
|===
4+|Revision History
|1.3
|2 Apr 2024
|MR
|Protocol names are lowercase (https://github.com/FirebirdSQL/firebird-documentation/issues/205[#205])
|1.2
|24 Feb 2024
a|* Replaced `isql -{wj}help` (invalid switch) with `isql -{wj}?` (valid switch)
Expand Down Expand Up @@ -3363,20 +3368,16 @@ Copyright (C) 2006.
All Rights Reserved.
Initial Writer contact: kamala dot vadlamani at gmail dot com.
Contributor: Paul Vinkenoog - see <<isql-dochist,Document history>>.
Contributors: Paul Vinkenoog, Norman Dunbar, Mark Rotteveel.
Portions created by Paul Vinkenoog are Copyright (C) 2008.
All Rights Reserved.
Contributor contact: paul at vinkenoog dot nl.
Contributor: Norman Dunbar - see <<isql-dochist,Document history>>.
Portions created by Norman Dunbar are Copyright (C) 2009, 2011-2013.
All Rights Reserved.
Contributor contact: NormanDunbar at users dot sourceforge dot net.
Contributor: Mark Rotteveel - see <<isql-dochist,Document history>>.
Portions created by Mark Rotteveel are Copyright (C) 2021-2024.
All Rights Reserved.
Contributor contact: mrotteveel at users dot sourceforge dot net.
Expand Down
@@ -1,7 +1,7 @@
[[qsg3]]
= Firebird 3 Quick Start Guide
IBPhoenix{sp}Editors; Firebird{sp}Project{sp}Members
5.6, 8 November 2023
5.7, 2 April 2024
:doctype: book
:sectnums:
:sectanchors:
Expand Down Expand Up @@ -1067,7 +1067,7 @@ That is, if the `Engine12` provider is enabled in `firebird.conf` or `databases.
If the database file exists, but the connection fails because the client process doesn't have the required access privileges to the file, a client-server connection is attempted (by the `Loopback` provider), in this order:
. Using TCP/IP via `localhost`;
. On Windows: using WNET (NetBEUI), aka Named Pipes, on the local machine;
. On Windows: using WNET (a.k.a. NetBEUI or Named Pipes), on the local machine;
. On Windows: using XNET (shared memory) on the local machine.
You can force Firebird to use a certain protocol (and skip the embedded connection attempt) by prepending the protocol in URL style:
Expand Down Expand Up @@ -2044,9 +2044,15 @@ Added "`(and `Engine12` enabled!)`" to last para.
|Update reference to firebird-devel (switch to Google Groups)
|5.6
|08 Nov 2023
|8 Nov 2023
|MR
|Remove mention that `ServerMode` is per-database configurable (it's not)
|5.7
|2 Apr 2024
|MR
|Protocol names are lowercase (https://github.com/FirebirdSQL/firebird-documentation/issues/205[#205])
|===
:sectnums:
Expand All @@ -2068,12 +2074,16 @@ Copyright (C) 2002-2004.
All Rights Reserved.
Initial Writer contact: hborrie at ibphoenix dot com.
Contributor: Paul Vinkenoog - see <<qsg3-dochist,document history>>.
Contributors: Paul Vinkenoog, Mark Rotteveel.
Portions created by Paul Vinkenoog are Copyright (C) 2004-2016.
All Rights Reserved.
Contributor contact: paul at vinkenoog dot nl.
Portions created by Mark Rotteveel are Copyright (C) 2020-2024.
All Rights Reserved.
(Contributor contact(s): mrotteveel at users dot sourceforge dot net).
:sectnums:
ifdef::backend-docbook,backend-pdf[]
Expand Down
@@ -1,7 +1,7 @@
[[qsg5]]
= Firebird 5 Quick Start Guide
IBPhoenix{sp}Editors; Mark Rotteveel; Firebird{sp}Project{sp}Members
0.2; 8 November 2023
0.3; 2 April 2024
:doctype: book
:sectnums:
:sectanchors:
Expand Down Expand Up @@ -1202,7 +1202,7 @@ In fact, specifying an explicit database path is one of the rare occasions where
The syntax for XNET URLs is:
`++{++xnet++}++://<path-or-alias>`
`xnet://<path-or-alias>`
Since XNET is a purely local protocol, you can't include a hostname or port.
Expand Down Expand Up @@ -1781,6 +1781,11 @@ The exact file history is recorded in the firebird-documentation git repository;
|===
4+|Revision History
|0.3
|2 Apr 2024
|MR
|Protocol names are lowercase (https://github.com/FirebirdSQL/firebird-documentation/issues/205[#205])
|0.2
|08 Nov 2023
|MR
Expand Down Expand Up @@ -1830,7 +1835,7 @@ Portions created by Paul Vinkenoog are Copyright (C) 2004-2016.
All Rights Reserved.
Contributor contact: paul at vinkenoog dot nl.
Portions created by Mark Rotteveel are Copyright (C) 2020-2023.
Portions created by Mark Rotteveel are Copyright (C) 2020-2024.
All Rights Reserved.
Contributor contact: mrotteveel at users dot sourceforge dot net.
Expand Down
Expand Up @@ -10,6 +10,11 @@ The exact file history is recorded in our _git_ repository; see https://github.c
|===
4+|Revision History

|1.20
|2 Apr 2024
|MR
|Protocol names are lowercase (https://github.com/FirebirdSQL/firebird-documentation/issues/205[#205])

|1.19
|17 Jan 2024
|MR
Expand Down
Expand Up @@ -203,11 +203,11 @@ In this syntax, the first part specifies the name of the protocol, then a host n

The following values can be specified as the protocol:

INET:: TCP/IP (first tries to connect using the IPv6 protocol, if it fails, then IPv4)
INET4:: TCP/IP v4 (since Firebird 3.0.1)
INET6:: TCP/IP v6 (since Firebird 3.0.1)
WNET:: NetBEUI or Named Pipes Protocol
XNET:: local protocol (does not include a host, port and service name)
inet:: TCP/IP (first tries to connect using the IPv6 protocol, if it fails, then IPv4)
inet4:: TCP/IP v4 (since Firebird 3.0.1)
inet6:: TCP/IP v6 (since Firebird 3.0.1)
wnet:: NetBEUI or Named Pipes Protocol
xnet:: local protocol (does not include a host, port and service name)

[listing,subs=+quotes]
----
Expand Down
@@ -1,7 +1,7 @@
[[fblangref30]]
= Firebird 3.0 Language Reference
Dmitry Filippov; Alexander Karpeykin; Alexey Kovyazin; Dmitry Kuzmenko; Denis Simonov; Paul Vinkenoog; Dmitry Yemanov; Mark Rotteveel
1.19, 17 January 2024
1.20, 2 April 2024
:doctype: book
:sectnums:
:sectanchors:
Expand Down

0 comments on commit d08096d

Please sign in to comment.