Re: [Firebird-docs] Adding new doc "Firebird UDRs in Pascal"
Hello, Lets put there IDPL. Regards, Alexey Kovyazin Денис Симонов via Firebird-docs : > I don't mind. This article was originally created for general access, > although I did not think about the license, but if necessary, I can add so > that there is no contradiction > > -- > Regards, > Simonov Denis. > вторник, 19 сентября 2023г., 19:02 +03:00 от Mark Rotteveel via > Firebird-docs firebird-docs@lists.sourceforge.net: > > On 19-09-2023 13:12, Köditz, Martin wrote: > > I have recently translated the document "Writing Firebird UDRs in > > Pascal" by Denis Simenov into English. If you and Denis agree, I would > > include both the Russian and English versions in the general > documentation. > > > > What is your opinion about this? > > I don't see a problem with it *if* Denis agrees, and if there is a clear > license for the documentation. > > Apart from that, in the future please use firebird-devel > (https://groups.google.com/g/firebird-devel) also for documentation > related discussions. > > 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 > ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Outdated documents
Hello Mark, May be we can map page of multi page document to the link of single page document with anchor? Regards, Alexey Kovyazin пн, 5 июл. 2021 г., 22:09 Mark Rotteveel : > On 05-07-2021 20:04, Alexey Kovyazin wrote: > > I just found that we have a hidden nest of old versions of many documents > > > > https://www.firebirdsql.org/pdfmanual/html/ > > > > and many of them seems to be well-ranked by Google :( > > > > I think the best solution will be to create mapping through nginx or > > similar to the actual versions, so it will be seamlessly unified, > > without many 404 on site. > > Is it Ok? or could be another solution? > > I'll look it over and coordinate with Sergey to add the necessary > redirects. I'm already maintaining a list of such redirects for > documentation. > > One of the problems is that multi-html documents are probably better for > search-engine ranking. I'm currently investigating options to > reintroduce multi-html documents again (at least for the language > references). > > 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
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] gstat OST - OIT and Sweep
Hello Martin, I spoke with Vlad about section devoted to garbage, and we agreed it is difficult. I plan to rewrite it with pictures explaining records versions, garbage and sweep, but it really needs courage :) I suggest to let ost-oit phrases as is. Regards, Alexey Kovyazin IBSurgeon пт, 31 июл. 2020 г., 12:56 Köditz, Martin : > Hi, > > > > I’m currently working on gstat-de. I struggled with following part: > > > > Many web sites, books, manuals (previously including this one) explain > that the automatic sweep is activated when OAT - OIT is greater than the > sweep interval. > > This is _not_ the case as explained by Vlad Khorsun, one of the Firebird > developers, who explained that it is when OST -- OIT is greater than the > threshold that the sweep is activated. > > > > What does the last sentence exactly mean? Can someone „tidy“ it? > > > > Regards > > Martin > ___ > 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] Translation of Russian Firebird 3.0 Language Reference
Hello, We did survey in Telegram channel, and idea was to skip 3.0 and do the translation of LR4.0... Regards, Alexey Kovyazin IBSurgeon чт, 30 июл. 2020 г., 12:55 Mark Rotteveel : > On 2020-07-30 09:44, Köditz wrote: > > Hello everybody, > > > > I was asked whether it would make sense to start a crowdfunding > > campaign for the translation of the Russian Firebird 3.0 Language > > Reference into English. > > > > Or are there already other efforts to implement it? > > I'm not sure if that is a viable course of action. IIRC, the translation > effort for 2.5 cost quite a lot (the initial idea was that the money > collected would also go toward translating the 3.0 version, but not > enough was left) and also required a lot of post-translation editing by > Helen to fix glaring translation errors. I'm considering to spend some > time to use the current 2.5 version as a basis to go to 3.0 (and then to > 4.0), where I may use Google translate on the Russian 3.0 version, but > might also just write things from scratch. However, I haven't made solid > plans for that yet as I first want to finish up the migration to > AsciiDoc. > > Mark > > > ___ > 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 File and Metadata Security migrated
Hello, I support the idea of the single Page list/index for all docs. I suggest that we should create such page, and then ask people about their opinion (it will also increase awareness of documentation). Regards, Alexey Kovyazin ср, 1 июл. 2020 г., 16:31 Paul Vinkenoog : > Mark Rotteveel wrote: > > > I migrated the Firebird File and Metadata Security document. > (...) > > I do wonder if this document really belongs under 'Reference Manuals', I > > think it would be more suitable under White Papers & Presentations.. > > I think the whole categorization is seriously flawed. > > First we have the top-level categories: > > - Release Notes > - Reference Manuals > - White Papers & Presentations > - FAQ > - Firebird Books > - Drivers Documentation > - Third-Party Docs and Articles > > each corresponding to a separate webpage. > > Then within those categories (i.e. on most of those webpages) we have > further subdivisions. For the page "Reference Manuals", they are: > > - Current Versions > - Firebird Command Line Tools > - Various User Manuals > - Reference Material (h? I thought the whole page was Reference > Manuals) > - Firebird Licenses > > and a couple more. > > Given the fact that the bulk of our docs is on the "Reference Manuals" > page, even if they aren't reference manuals, I think that the Firebird > File and Metadata Security document is reasonably well placed under > "Various User Manuals". > > Now, this isn't a pressing matter, but I do think that we should have > the Doc index back on a single page again (except maybe for a few docs/ > categories that are heavily "niche" and/or outdated and/or third-party), > with categories that make sense, and without separate lines for each > language version, because that's eating up huge amounts of vertical > space. > > Paul Vinkenoog > > > ___ > 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] Conversion of fbutil-*
Hello Mark, I think it is necesary to keep the current structure, and unite them only virtually, since "command line tools" is a weak basis for grouping such different tools. Theoretically, they should be parts of Firebird Admin Guide, but now they are just pieces. Another question - do you plan to convert also Developers Guide? Regards, Alexey Kovyazin пн, 15 июн. 2020 г., 21:13 Mark Rotteveel : > I was planning on converting the fbutil-* documentation next, however I > was wondering how to approach this. Historically, we have released those > as individual documentation, while at the same time they were also > intended to be a single volume (the "Firebird Command Line Utilities" > book). > > Should I convert them individually (and 'throw away' the fbutil-intro, > fbutil-outro and fbutil-appendix that are only referred from the > "Firebird Command Line Utilities" book), or should I try to preserve > this by allowing them to be built as individual books and as a combined > volume? > > I should note that the text in the intro and outro is outdated because > it wasn't updated for several utilitities that are actually documented > (like gfix, gstat and isql). > > 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] The single Page for the documentation outline
Hello Mark, Like that Page but with high level table of contents for each document. Regards, Alexey Kovyazin ср, 27 мая 2020 г., 14:25 Mark Rotteveel : > On 2020-05-27 09:43, Alexey Kovyazin (ak) wrote: > > Hello All, > > > > As you know, Firebird documentation contains a set of documents, and > > they are grouped in several pages, by the topic or type of documents, > > like Release Notes, etc. > > > > Should we consider build the overall list of the docs and put to the > > Documentation starting Page? > > > > It would be like a big outline. Not like a 100% organized > > documentation set, of co3, but better than current distributed > > structure. > > > > What do you think? > > I'm not sure what you mean. This sounds like what we already have at > https://firebirdsql.org/en/firebird-rdbms/, that page and its subpages > is that list as I see it. > > Mark > > > ___ > 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
[Firebird-docs] The single Page for the documentation outline
Hello All, As you know, Firebird documentation contains a set of documents, and they are grouped in several pages, by the topic or type of documents, like Release Notes, etc. Should we consider build the overall list of the docs and put to the Documentation starting Page? It would be like a big outline. Not like a 100% organized documentation set, of co3, but better than current distributed structure. What do you think? Regards, Alexey Kovyazin ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
