Re: [Firebird-docs] Firebird 3.0 Language Reference
On 2021-02-24 07:21, Simonov Denis via Firebird-docs wrote: Mark Rotteveel wrote Sat, 20 Feb 2021 19:02:25 +0300: I have finished up the first version of the Firebird 3.0 Language Reference, I used the 2.5 version as starting point, and added new things based on the release notes and the Russian Firebird 3.0 Language Reference, and made corrections based on inspecting the actual syntax and close reading of the existing text. Great job! Thank. Thanks How about preparing the "Firebird 4.0 Language Reference"? Yes, I have already started working on a version 4 language reference, but first I need to spend some more time on Jaybird and r2dbc-firebird ;) I already have a Russian version, which is generally ready, but there will be small changes when going RC -> Release. I will try in the near future to bring the structure of the table of contents in line with your document. I will also try to translate my document into asciidoc format. I used https://github.com/mrotteveel/docbookrx/tree/firebird-modifications to convert the old Firebird docbook sources to Asciidoc, maybe it can be useful for you too. However the Firebird docbook sources were using Docbook 4.5, and although I believe this tool supports both, there might be some issues (I had to make some modifications to fix conversions). Mark ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Firebird 3.0 Language Reference
Mark Rotteveel wrote Sat, 20 Feb 2021 19:02:25 +0300: I have finished up the first version of the Firebird 3.0 Language Reference, I used the 2.5 version as starting point, and added new things based on the release notes and the Russian Firebird 3.0 Language Reference, and made corrections based on inspecting the actual syntax and close reading of the existing text. Great job! Thank. How about preparing the "Firebird 4.0 Language Reference"? I already have a Russian version, which is generally ready, but there will be small changes when going RC -> Release. I will try in the near future to bring the structure of the table of contents in line with your document. I will also try to translate my document into asciidoc format. https://github.com/sim1984/langref40 https://github.com/sim1984/langref40/releases/download/langref40/langref40.pdf -- Simonov Denis ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Firebird 3.0 Language Reference
Hello, I took a quick look and did not see any noticeable problem. Regards, Alexey вт, 23 февр. 2021 г., 19:27 Mark Rotteveel : > I'm going to publish the links tomorrow. > > Mark > > On 20-02-2021 17:02, Mark Rotteveel wrote: > > I have finished up the first version of the Firebird 3.0 Language > > Reference, I used the 2.5 version as starting point, and added new > > things based on the release notes and the Russian Firebird 3.0 Language > > Reference, and made corrections based on inspecting the actual syntax > > and close reading of the existing text. > > > > Before I put the links up on the website, I'd like another set of eyes > > on it. Not so much content-wise, as more layout-wise (e.g. weird > > rendering problems), as by now I'm seeing a bit cross-eyed ;) > > > > Links: > > > > HTML: > > > https://firebirdsql.org/file/documentation/html/en/refdocs/fblangref30/firebird-30-language-reference.html > > > > > > PDF: > > > https://firebirdsql.org/file/documentation/pdf/en/refdocs/fblangref30/firebird-30-language-reference.pdf > > > > > > I committed the document as one large commit. Originally, I had it > > separated out into individual commits, but somewhere along the way I got > > sidetracked by making consistency changes all over the document, or a > > change in one part triggered a revision elsewhere, and in the end I gave > > up on making incremental commits and decided to just use one commit. My > > apologies to translators for this, but it was the only way to retain my > > sanity. > > > > If you need to diff sources to find out what changed, I recommend taking > > the Firebird 2.5 Language Reference sources, rename them to match the > > 3.0 version, and split the DDL and Security chapter in similar fashion > > as done for the 3.0 version (per keyword or subject). > > > > Mark > > > -- > Mark Rotteveel > > > ___ > Firebird-docs mailing list > Firebird-docs@lists.sourceforge.net > https://lists.sourceforge.net/lists/listinfo/firebird-docs > ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Firebird 3.0 Language Reference
I'm going to publish the links tomorrow. Mark On 20-02-2021 17:02, Mark Rotteveel wrote: I have finished up the first version of the Firebird 3.0 Language Reference, I used the 2.5 version as starting point, and added new things based on the release notes and the Russian Firebird 3.0 Language Reference, and made corrections based on inspecting the actual syntax and close reading of the existing text. Before I put the links up on the website, I'd like another set of eyes on it. Not so much content-wise, as more layout-wise (e.g. weird rendering problems), as by now I'm seeing a bit cross-eyed ;) Links: HTML: https://firebirdsql.org/file/documentation/html/en/refdocs/fblangref30/firebird-30-language-reference.html PDF: https://firebirdsql.org/file/documentation/pdf/en/refdocs/fblangref30/firebird-30-language-reference.pdf I committed the document as one large commit. Originally, I had it separated out into individual commits, but somewhere along the way I got sidetracked by making consistency changes all over the document, or a change in one part triggered a revision elsewhere, and in the end I gave up on making incremental commits and decided to just use one commit. My apologies to translators for this, but it was the only way to retain my sanity. If you need to diff sources to find out what changed, I recommend taking the Firebird 2.5 Language Reference sources, rename them to match the 3.0 version, and split the DDL and Security chapter in similar fashion as done for the 3.0 version (per keyword or subject). Mark -- Mark Rotteveel ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Firebird 3.0 Language Reference
Hello Mark, Great work! Thank you vey much! I will read it, of course. Regards, Alexey On 20.02.2021 19:02, Mark Rotteveel wrote: I have finished up the first version of the Firebird 3.0 Language Reference, I used the 2.5 version as starting point, and added new things based on the release notes and the Russian Firebird 3.0 Language Reference, and made corrections based on inspecting the actual syntax and close reading of the existing text. Before I put the links up on the website, I'd like another set of eyes on it. Not so much content-wise, as more layout-wise (e.g. weird rendering problems), as by now I'm seeing a bit cross-eyed ;) Links: HTML: https://firebirdsql.org/file/documentation/html/en/refdocs/fblangref30/firebird-30-language-reference.html PDF: https://firebirdsql.org/file/documentation/pdf/en/refdocs/fblangref30/firebird-30-language-reference.pdf I committed the document as one large commit. Originally, I had it separated out into individual commits, but somewhere along the way I got sidetracked by making consistency changes all over the document, or a change in one part triggered a revision elsewhere, and in the end I gave up on making incremental commits and decided to just use one commit. My apologies to translators for this, but it was the only way to retain my sanity. If you need to diff sources to find out what changed, I recommend taking the Firebird 2.5 Language Reference sources, rename them to match the 3.0 version, and split the DDL and Security chapter in similar fashion as done for the 3.0 version (per keyword or subject). Mark ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
[Firebird-docs] Firebird 3.0 Language Reference
I have finished up the first version of the Firebird 3.0 Language Reference, I used the 2.5 version as starting point, and added new things based on the release notes and the Russian Firebird 3.0 Language Reference, and made corrections based on inspecting the actual syntax and close reading of the existing text. Before I put the links up on the website, I'd like another set of eyes on it. Not so much content-wise, as more layout-wise (e.g. weird rendering problems), as by now I'm seeing a bit cross-eyed ;) Links: HTML: https://firebirdsql.org/file/documentation/html/en/refdocs/fblangref30/firebird-30-language-reference.html PDF: https://firebirdsql.org/file/documentation/pdf/en/refdocs/fblangref30/firebird-30-language-reference.pdf I committed the document as one large commit. Originally, I had it separated out into individual commits, but somewhere along the way I got sidetracked by making consistency changes all over the document, or a change in one part triggered a revision elsewhere, and in the end I gave up on making incremental commits and decided to just use one commit. My apologies to translators for this, but it was the only way to retain my sanity. If you need to diff sources to find out what changed, I recommend taking the Firebird 2.5 Language Reference sources, rename them to match the 3.0 version, and split the DDL and Security chapter in similar fashion as done for the 3.0 version (per keyword or subject). Mark -- Mark Rotteveel ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
