Re: [Firebird-docs] ATTN Norman: isql guide
On 18/07/11 14:37, Dmitry Yemanov wrote: SHOW commands operate on a separate transaction from user statements. They run as READ COMMITTED background statements and acknowledge all metadata changes immediately. Thanks. I've updated the isql manual with these details. Cheers, Norm. -- Norman Dunbar Dunbar IT Consultants Ltd Registered address: Thorpe House 61 Richardshaw Lane Pudsey West Yorkshire United Kingdom LS28 7EL Company Number: 05132767 -- AppSumo Presents a FREE Video for the SourceForge Community by Eric Ries, the creator of the Lean Startup Methodology on Lean Startup Secrets Revealed. This video shows you how to validate your ideas, optimize your ideas and identify your business strategy. http://p.sf.net/sfu/appsumosfdev2dev ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] XML Mind new version - Warnings!
On 26/09/11 03:16, Paul Vinkenoog wrote: On Fri, 26 Sep 2008 17:10:26 +0200, Norman Dunbar wrote: Eh? ;-) ... Solved! Now is that quick or what? :-) Extremely - thanks! Actually, since I originally posted that, I've been using XML Mind version 4.3.0_01 which is happy to handle xincludes without - as far as I know - requiring xerces. I can honestly say that xinclude is by far a wonderful way of including another document - or part of another document - easily. Equally, the other document can be edited in XML Mind as it has the docbook header present. Cheers, Norm. -- Norman Dunbar Dunbar IT Consultants Ltd Registered address: Thorpe House 61 Richardshaw Lane Pudsey West Yorkshire United Kingdom LS28 7EL Company Number: 05132767 -- All the data continuously generated in your IT infrastructure contains a definitive record of customers, application performance, security threats, fraudulent activity and more. Splunk takes this data and makes sense of it. Business sense. IT sense. Common sense. http://p.sf.net/sfu/splunk-d2dcopy1 ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Update of build system
Hi Paul, The value in the penultimate line looks dodgy to me. Should that comma be there? Yes, it's a delimiter. Everything in docbook/images/callouts *and* everything in images must be copied. Ok, thanks. PS. Build monohtml takes 37 seconds with Sun Java compared to over 12 minutes (to fail) with OpenJDK. For the entire set, 37 seconds is acceptable I guess. For a single document, it's long (on a modern system). I did another set of timings: monohtml: 37 seconds html: 35 seconds pdf: 41 seconds docs: 1:33. The sum of the parts doesn't add up to the total for everything. I suspect lots of stuff whizzing into and out of memory - seeing as how ant is Java and xml etc. Most likely delays are in writing the thousands or warnings to the console I expect! ;-) Cheers, Norm. -- Norman Dunbar Dunbar IT Consultants Ltd Registered address: Thorpe House 61 Richardshaw Lane Pudsey West Yorkshire United Kingdom LS28 7EL Company Number: 05132767 -- All the data continuously generated in your IT infrastructure contains a definitive record of customers, application performance, security threats, fraudulent activity and more. Splunk takes this data and makes sense of it. Business sense. IT sense. Common sense. http://p.sf.net/sfu/splunk-d2dcopy1 ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
[Firebird-docs] Checking out the B_Release branch
If you are a bit weak on the workings or CVS, like I am, then the following will hopefully help you check out the new B_Release branch of the manual module. # # get into my normal working area. # cd SourceCode/cvs/firebird/ # # Create a new directory for the branch. # mkdir b_release cd b_release # # Checkout the new branch into the current directory. # (All on one line!) # Replace my_username with your Source Forge username. # Note: Spelling of B_Release is critical! # cvs -z6 -d:ext:my_usern...@firebird.cvs.sourceforge.net:/cvsroot/firebird checkout -r B_Release manual # # Did it work? # ls At this point you should find that you have a new directory called manual in your current directory. That is the B_Release branch. The B_Release branch is only for manuals that are complete and build correctly. DO NOT commit any half edited or unbuildable manuals into this branch please. (Lest Paul descend upon you with wrath!) So, when you are working on manuals the easiest process to follow is: * Edit everything in the working location - /SourceCode/cvs/firebird/manual/src/docs/firebirddocs in my case. Feel free to commit partial changes etc to this location. * Build the completed docs, and check them for correctness, pdf overflows, spelling etc. * When satisfied, commit them into cvs in the usual manner. So far, nothing spectacular. However, once the manual(s) are complete and build correctly, they are ready for release. They must be copied into the B_Release branch. * Copy any updated manuals' XML files into the b_release location - /SourceCode/cvs/firebird/b_release/manual/src/docs/firebirddocs/ in my case. * Commit these documents back to cvs in the usual manner. HTH Cheers, Norm. -- Norman Dunbar Dunbar IT Consultants Ltd Registered address: Thorpe House 61 Richardshaw Lane Pudsey West Yorkshire United Kingdom LS28 7EL Company Number: 05132767 -- All the data continuously generated in your IT infrastructure contains a definitive record of customers, application performance, security threats, fraudulent activity and more. Splunk takes this data and makes sense of it. Business sense. IT sense. Common sense. http://p.sf.net/sfu/splunk-d2d-oct ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] firebirdintro.xml
Hi Paul, Are there any objections to sending firebirdintro.xml to the attic? It's a stub, written ages ago by David Jencks and it's not likely that we are ever going to use it. Not from me. As far as I can see, it's never used. Cheers, Norm. -- Norman Dunbar Dunbar IT Consultants Ltd Registered address: Thorpe House 61 Richardshaw Lane Pudsey West Yorkshire United Kingdom LS28 7EL Company Number: 05132767 -- All the data continuously generated in your IT infrastructure contains a definitive record of customers, application performance, security threats, fraudulent activity and more. Splunk takes this data and makes sense of it. Business sense. IT sense. Common sense. http://p.sf.net/sfu/splunk-d2d-oct ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] firebirddocs.xml and subtree updated
Morning Paul, Norman, I've also done this in one of your documents: fbdoc_vpn.xml, because I wanted fb-docwriters-info.xml and subdocuments to be consistent. Hope you don't mind. I left the rest of your stuff alone ;-) Hmm. Surely the fbdoc_vpn.xml file is as equally obsolete as the firebirdintro.xml? The VPN method of accessing the server to upload documents is no longer in use what with the new CMS and the (blisteringly fast) new server? I was considering deleting that file. I was actually working, yesterday, on my command line utility manuals to allow them to be included - so I've got a couple of changes in that department coming soon myself. Also, XMLMind complained that fbutil_gbak.xml was invalid: you should wrap therevhistory in apara tot fix it. It doesn't matter for the build though: the build system doesn't validate the sources against the DocBook DTD - it just breaks if things get too weird, or if the XML is not well-formed. Yes, I noticed that but only after I use includes. Strange. The revision in question was copied and pasted in XXE. I'm looking into this at the moment. It's a tad strange! Anyway, for everybody who has a local copy of the manual tree, it's probably a good idea to do a cvs update. Consider it about to be done. Cheers, Norm. -- Norman Dunbar Dunbar IT Consultants Ltd Registered address: Thorpe House 61 Richardshaw Lane Pudsey West Yorkshire United Kingdom LS28 7EL Company Number: 05132767 -- All the data continuously generated in your IT infrastructure contains a definitive record of customers, application performance, security threats, fraudulent activity and more. Splunk takes this data and makes sense of it. Business sense. IT sense. Common sense. http://p.sf.net/sfu/splunk-d2d-oct ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Upload server problems?
Morning Paul, On 31/10/12 02:54, Paul Vinkenoog wrote: Maybe some update on the Firebird server or - as Lester suggests - due to the fact that you cleaned up things on your side. FWIW, I can connect without any problem. User names and passwords aren't used, only pubkeys. Yours is still there; I checked it against the one you sent me back in August 2010 and it's identical. The associated email address is nor...@hubble.dunbar-it.co.uk, but AFAIK that part is just informational (1). You don't provide an email address when connecting; just as long as your system has the private key that corresponds to the public key on the server, things should work out. I do still have my private key to match the public one already submitted I made a serious point of making sure I preserved everything in /home! This is what happens, with a lot of the messages removed for brevity: norman@hubble ~ $ ssh nor...@www.firebirdsql.org @@@ @ WARNING: POSSIBLE DNS SPOOFING DETECTED! @ @@@ The RSA host key for www.firebirdsql.org has changed, and the key for the corresponding IP address 62.141.46.210 is unknown. ... @@@ @WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! @ @@@ IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY! ... It is also possible that a host key has just been changed. The fingerprint for the RSA key sent by the remote host is 88:5e:b0:80:96:c0:e2:89:f8:52:a4:d8:a1:bc:9b:5f. Please contact your system administrator. Add correct host key in /home/norman/.ssh/known_hosts to get rid of this message. Offending RSA key in /home/norman/.ssh/known_hosts:29 remove with: ssh-keygen -f /home/norman/.ssh/known_hosts -R www.firebirdsql.org RSA host key for www.firebirdsql.org has changed and you have requested strict checking. Host key verification failed. norman@hubble ~ $ ssh-keygen -f /home/norman/.ssh/known_hosts -R www.firebirdsql.org /home/norman/.ssh/known_hosts updated. Original contents retained as /home/norman/.ssh/known_hosts.old norman@hubble ~ $ ssh nor...@www.firebirdsql.org The authenticity of host 'www.firebirdsql.org (78.47.172.252)' can't be established. RSA key fingerprint is 91:3e:7e:28:ff:be:a5:c1:1d:f2:e1:bf:7c:ff:10:e6. Are you sure you want to continue connecting (yes/no)? yes Warning: Permanently added 'www.firebirdsql.org' (RSA) to the list of known hosts. Permission denied (publickey). norman@hubble ~ $ ssh nor...@www.firebirdsql.org @@@ @ WARNING: POSSIBLE DNS SPOOFING DETECTED! @ @@@ ... Ok, from the above I can see one or two things: * has the ip address changed on the server? The warning says that it is 62.141.46.210 while the second attempt is telling me it's 78.47.172.252. * why is it telling me that the fingerprint is 88:5e:b0:80:96:c0:e2:89:f8:52:a4:d8:a1:bc:9b:5f in the warnings and when I connect it says it is 91:3e:7e:28:ff:be:a5:c1:1d:f2:e1:bf:7c:ff:10:e6 instead? The above repeats as long as I want to keep trying. The warnings say one things the connection says another - and the end result is the same, I don't get a connection. If I ping the server I get 78.47.172.252 - so the warnings appear to be a pile of poo! I'll keep investigating Cheers, Norm. -- Norman Dunbar Dunbar IT Consultants Ltd Registered address: Thorpe House 61 Richardshaw Lane Pudsey West Yorkshire United Kingdom LS28 7EL Company Number: 05132767 -- Everyone hates slow websites. So do we. Make your web apps faster with AppDynamics Download AppDynamics Lite for free today: http://p.sf.net/sfu/appdyn_sfd2d_oct ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Upload server problems?
Morning Helen, (or is it, where you are?) On 31/10/12 08:59, Helen Borrie wrote: I don't think any of us has SFTP access to www.firebirdsql.org. To be honest, I can't remember! I'm sure I did have ssh and sftp to wherever we upload our docs to - I have to supply Sergey with a public key a long time back. ... 78.47.172.252 is the IP address corresponding to cms.firebirdsql.org, which is where we ordinary mortals upload and edit stuff. norman@hubble ~ $ nslookup cms.firebirdsql.org Server: 127.0.0.1 Address:127.0.0.1#53 Non-authoritative answer: Name: cms.firebirdsql.org Address: 78.47.172.253 252? or 253? I have an email from Sergey from 11th October 2011 telling me to login as www-data@78.47.172.253 and no password would be required. It seems this is not the case as I get prompted for www-data's password. Anyway, I'm having another conversation with Sergey even as I type. Hopefully, all will be well soon. Cheers, Norm. -- Norman Dunbar Dunbar IT Consultants Ltd Registered address: Thorpe House 61 Richardshaw Lane Pudsey West Yorkshire United Kingdom LS28 7EL Company Number: 05132767 -- Everyone hates slow websites. So do we. Make your web apps faster with AppDynamics Download AppDynamics Lite for free today: http://p.sf.net/sfu/appdyn_sfd2d_oct ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Error while building PDF
Sorry, auto correct trashed my reply! OpenJDK was no use either. Cheers, Norm. On 12 May 2017 09:40:09 BST, Norman Dunbar <nor...@dunbar-it.co.uk> wrote: >Morning Martin, > >I think that the IcedTea java environment is not suitable for fop to >create pdfs. I've got a recollection that this has bugged me in the >past. I'm pretty sure you need Sun/Oracle jave. > >Opened was no use either, at least according to a post of mine from >2011 (Update of Build System thread.) > >HTH > >Cheers, >Norm. > > >-- >Sent from my Android device with K-9 Mail. Please excuse my brevity. -- Sent from my Android device with K-9 Mail. Please excuse my brevity.-- Check out the vibrant tech community on one of the world's most engaging tech sites, Slashdot.org! http://sdm.link/slashdot___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Error while building PDF
Morning Martin, I think that the IcedTea java environment is not suitable for fop to create pdfs. I've got a recollection that this has bugged me in the past. I'm pretty sure you need Sun/Oracle jave. Opened was no use either, at least according to a post of mine from 2011 (Update of Build System thread.) HTH Cheers, Norm. -- Sent from my Android device with K-9 Mail. Please excuse my brevity.-- Check out the vibrant tech community on one of the world's most engaging tech sites, Slashdot.org! http://sdm.link/slashdot___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Test repository CVS to git migration
If anyone is interested, Pro Git (Second Edition) by Scott Chacon and Ben Straub is officially available as PDF or EPUB from Springer's Web Site at https://www.springer.com/gb/book/9781484200773 - I believe that Springer are associated with Apress who publish the book. The book is also available to read online at https://git-scm.com/book/en/v2 - which is interesting as I'm sure I've downloaded the PDF from there in the past. (Must check!) You can also get the ASCIIDOC source code for the book from Github at https://github.com/progit/progit2 and build a copy for yourself. The book is Open Source, (CC Attribution Non-Commercial Share-alike 3.0 Unported Licence) and you are encouraged to fix errors and create pull requests to get the corrections (and your name!) in the next edition. ;-) HTH Cheers, Norm. -- Norman Dunbar Dunbar IT Consultants Ltd Registered address: 27a Lidget Hill Pudsey West Yorkshire United Kingdom LS28 7LG Company Number: 05132767 -- Check out the vibrant tech community on one of the world's most engaging tech sites, Slashdot.org! http://sdm.link/slashdot ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Test repository CVS to git migration
On 17/10/17 14:41, Paul Beach wrote: I'm sure I've downloaded the PDF from there in the past. (Must check!) https://link.springer.com/book/10.1007%2F978-1-4842-0076-6 Regards Paul Thanks Paul, but I was referring to the fact that I had, in the past, downloaded the book from the https://git-scm.com/book/en/v2 address. :-) I already have it from the Springer address too, so I have both versions. Thanks again. Cheers, Norm. -- Norman Dunbar Dunbar IT Consultants Ltd Registered address: 27a Lidget Hill Pudsey West Yorkshire United Kingdom LS28 7LG Company Number: 05132767 -- Check out the vibrant tech community on one of the world's most engaging tech sites, Slashdot.org! http://sdm.link/slashdot ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] ATTN committers: SourceForge to terminate CVS support on November 30th
I agree with the git option too. Cheers, Norm. -- Sent from my Android device with K-9 Mail. Please excuse my brevity.-- Check out the vibrant tech community on one of the world's most engaging tech sites, Slashdot.org! http://sdm.link/slashdot___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Test repository CVS to git migration
Afternoon Paul, On 18/10/17 14:08, Paul Vinkenoog wrote: A number of source files in my (Windows) CVS working dir have Unix line endings though, whereas their Git counterparts have DOS endings. That's no problem, as long as it doesn't lead to a huge number of 'changes' and log messages when such a file is committed, cluttering the history and drowning the real changes. This is a documented feature of Git. Github has a document about how you can set up your git client to cope with this. The URL is https://help.github.com/articles/dealing-with-line-endings/. From the online "Pro Git" book, we have this from https://git-scm.com/book/en/v2/Customizing-Git-Git-Configuration (scroll down!): core.autocrlf If you’re programming on Windows and working with people who are not (or vice-versa), you’ll probably run into line-ending issues at some point. This is because Windows uses both a carriage-return character and a linefeed character for newlines in its files, whereas Mac and Linux systems use only the linefeed character. This is a subtle but incredibly annoying fact of cross-platform work; many editors on Windows silently replace existing LF-style line endings with CRLF, or insert both line-ending characters when the user hits the enter key. Git can handle this by auto-converting CRLF line endings into LF when you add a file to the index, and vice versa when it checks out code onto your filesystem. You can turn on this functionality with the core.autocrlf setting. If you’re on a Windows machine, set it to true – this converts LF endings into CRLF when you check out code: $ git config --global core.autocrlf true If you’re on a Linux or Mac system that uses LF line endings, then you don’t want Git to automatically convert them when you check out files; however, if a file with CRLF endings accidentally gets introduced, then you may want Git to fix it. You can tell Git to convert CRLF to LF on commit but not the other way around by setting core.autocrlf to input: $ git config --global core.autocrlf input This setup should leave you with CRLF endings in Windows checkouts, but LF endings on Mac and Linux systems and in the repository. If you’re a Windows programmer doing a Windows-only project, then you can turn off this functionality, recording the carriage returns in the repository by setting the config value to false: $ git config --global core.autocrlf false So, windows users need: $ git config --global core.autocrlf true and Linux and Mac users need: $ git config --global core.autocrlf input Anyway, I guess that won't occur if we commit all our work to CVS before the conversion/transition, get a fresh git clone afterwards and work only from that. Am I right? In a word, yes. Provided that you configure the Git client before checking out and definitely before checking in. Cheers, Norm. -- Norman Dunbar Dunbar IT Consultants Ltd Registered address: 27a Lidget Hill Pudsey West Yorkshire United Kingdom LS28 7LG Company Number: 05132767 -- Check out the vibrant tech community on one of the world's most engaging tech sites, Slashdot.org! http://sdm.link/slashdot ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Test repository CVS to git migration
On 18/10/17 15:15, Mark Rotteveel wrote: Given the normalization done during conversion, that should not be a problem (unless a new file extension is introduced that isn't considered a text file by the configuration of the conversion). The thing I mentioned with autocrlf is the old way of doing things, up to Git 1.6 I think. From then on, .gitattributes is the way to go. However, if a new file type appears, Git will determine whether it is a text file by checking to see if it fails the tests for binary files. There's a good explanation of why it might be best to have both settings at http://adaptivepatchwork.com/2012/03/01/mind-the-end-of-your-line/. Cheers, Norm. -- Norman Dunbar Dunbar IT Consultants Ltd Registered address: 27a Lidget Hill Pudsey West Yorkshire United Kingdom LS28 7LG Company Number: 05132767 -- Check out the vibrant tech community on one of the world's most engaging tech sites, Slashdot.org! http://sdm.link/slashdot ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] SourceForge CVS to GitHub migration done
Thanks for all the hard work on the migration Mark - it is appreciated. Would having issues enabled be better for people to log bugs in the docs perhaps? Cheers, Norm. -- Sent from my Android device with K-9 Mail. Please excuse my brevity.-- Check out the vibrant tech community on one of the world's most engaging tech sites, Slashdot.org! http://sdm.link/slashdot___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Test repository CVS to git migration
Hi Mark, On 04/11/17 12:42, Mark Rotteveel wrote: And although it is not an impediment for the migration itself, it would be handy to have a list of the GitHub usernames of contributors that need commit access to the repository. Mine is "NormanDunbar" - if you want it now that is! Alternatively, contributors could use forks and use pull requests for their contributions. I think that this might be the better idea, but it will mean that a "benevolent dictator" (or similar) would be required to actually check and merge the pull requests. It's reasonably simple to have a fork and keep it up to date with a remote pointing at the original repository, and a "git pull" from that remote. Cheers, Norm. -- Norman Dunbar Dunbar IT Consultants Ltd Registered address: 27a Lidget Hill Pudsey West Yorkshire United Kingdom LS28 7LG Company Number: 05132767 -- Check out the vibrant tech community on one of the world's most engaging tech sites, Slashdot.org! http://sdm.link/slashdot ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Experimenting with asciidoc / asciidoctor
Issue 921 opened on github. (Asciidoctor-pdf) Cheers, Norm. -- Sent from my Android device with K-9 Mail. Please excuse my brevity and any "auto corrections" that are just wrong!-- Check out the vibrant tech community on one of the world's most engaging tech sites, Slashdot.org! http://sdm.link/slashdot___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Can contribute
I thought the VPN was ancient history? Am I wrong? I remember writing the docs for how to use it, and then it got changed so that we simply provide an ssh public key (but not dsa!) and that gives us access to sftp our documents directly to the web site. I need to write a new set of "how to upload" manuals! Correct me please, if I'm wrong - it wouldn't be the first time! Cheers, Norm. -- Sent from my Android device with K-9 Mail. Please excuse my brevity.-- Check out the vibrant tech community on one of the world's most engaging tech sites, Slashdot.org! http://sdm.link/slashdot___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Request for testing gradle build to replace ant build
Hi Mark, Paul, I've been attempting to get Gradle working on my box to try out the new build. Finally found time. :) Of course, it's not yet mnerged, I assume it's still in your fork Mark? If so, I'll get a few attempts at building done soon. Then I'll start experimenting with asciidoc/asciidoctor. If you need any questions, I might be able to help - having just done an entire 400 page book in Asciidoctor, using asciidoctor-pdf as the generator. One thing you will find useful is this: // If the backend is PDF then do this. ifdef::backend-pdf[] [width=60%, cols="20%,40%,20%,20%", align = "center", caption="Table 9."] endif::[] // If the backend is html, then do this instead. ifdef::backend-html5[] [width=60%, cols="20%,40%,20%,20%", float = "center", caption="Table 9."] endif::[] .2 - ADC prescaler settings and frequencies. |=== // Insert Table Contents Here // |=== I found that when generating tables in a PDF and HTML, they need different commands to centre them on the page. It's a bit of a bind that the widths cannot be written then the ifdef embedded, so you have to duplicate the widths etc in both options. Captions are interesting. The above would give a table the caption of "Table 9.2 - ADC prescaler settings and frequencies" Asciidoctor has manual table/listing/etc numbering so moving or adding sections will require lots of updating of captions etc. A right major pain! (Ask me how I know!) Good luck and have fun with asciidoctor. (My current book is being written in Lyx!) Cheers, Norm. -- Norman Dunbar Dunbar IT Consultants Ltd Registered address: 27a Lidget Hill Pudsey West Yorkshire United Kingdom LS28 7LG Company Number: 05132767 ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] doc building failure
My build system is Oracle Java 8 as it's the most recent version that works. Cheers, Norm. -- Sent from my Android device with K-9 Mail. Please excuse my brevity.___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] doc building failure
Hi Mark, it has never worked with Open JDK for as long as I've been involved. I'm sure I posted either here or in a Doc about it and how to get around it. Good luck. Cheers, Norm. -- Sent from my Android device with K-9 Mail. Please excuse my brevity. On 7 January 2020 12:24:16 GMT, Mark Rotteveel wrote: >On 2020-01-06 17:21, Norman Dunbar wrote: >> And, if you have got the proper libraries and tools installed, you >> need to use an Oracle version of Java with a version 8 or lower, or >it >> will not build with Open JDK, nor will it build with Java 9 and >> higher. > >I haven't build the docs recently, but I'd be surprised if it works >with >Oracle Java 8, but fails with OpenJDK 8. I'll see if I can reproduce it > >and come up with a fix. > >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] Do we need/want chunked HTML?
Hi Mark, I actually prefer chunky html, sorry. It loads quicker over single files. True, I can't search the whole file, but if I needed that I'd use the pdf. Having said that, I'm happy to lose the chunky version, if necessary. Cheers, Norm. -- Sent from my Android device with K-9 Mail. Please excuse my brevity.___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Example of new documentation
Morning All, Hopefully we are all staying safe. I'm with Paul, the second version is much better. Cheers, Norm. -- Sent from my Android device with K-9 Mail. Please excuse my brevity.___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] First 'new' documents online
Hi Martin, I don't believe that you can, currently, create chunked HTML with Asciidoctor. s Mark stated in his thread recently about Chunked HTML: Asciidoctor does not support chunked HTML output (there is an experimental, third-party plugin, but that plugin is tied to a specific, out-of-date asciidoctor version). HTH Cheers, Norm. On 26/05/2020 14:17, Köditz, Martin wrote: Please, forget my previous Mail. I found everything in the new Docs. But how can I create the chunked output? Regards Martin Hi Mark, I'd like to update the German docs. What do I have to do? Regards Martin ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs -- Norman Dunbar Dunbar IT Consultants Ltd Registered address: 27a Lidget Hill Pudsey West Yorkshire United Kingdom LS28 7LG Company Number: 05132767 ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Style of rendering parameters
I prefer the definition list. Cheers, Norm. -- Sent from my Android device with K-9 Mail. Please excuse my brevity.___ 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
Oh dear, I wrote that! Originally, if I remember correctly, I might have mentioned that the sweep would be started when OAT - OIT was greater than the sweep interval. This was s I had seen in books, online, etc. Vlad, complained to me that I had written wrongly, and that the sweep would be started when OST - OIT was greater than the sweep interval. OAT = Oldest Active Transaction. OIT = Oldest Interesting Transaction. OST = Oldest Snapshot Transaction. Cheers, Norm. -- Sent from my Android device with K-9 Mail. Please excuse my brevity.___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Conversion of release notes
Looks excellent from where I'm sitting. Thanks. Cheers, Norm. -- Sent from my Android device with K-9 Mail. Please excuse my brevity.___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Firebird 2.5 Language Reference migration preview
I favour option 1 then option 2 Mark. Cheers, Norm. -- Sent from my Android device with K-9 Mail. Please excuse my brevity.___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Experimental chunked output
I like it. The styling looks good to my eye. The quick TOC pop-up (pop-down) is a nice touch. It's readable on my phone in portrait and landscape mode which is nice. It's a little tiny bit too big though and I have to adjust the size slightly. But that's not a huge problem. Cheers, Norm. -- Sent from my Android device with K-9 Mail. Please excuse my brevity. On 28 September 2021 15:15:01 BST, Mark Rotteveel wrote: >I'm experimenting with producing chunked output for at least the >language references. > >I have uploaded an example at >https://www.firebirdsql.org/file/documentation/chunk/en/refdocs/fblangref40/firebird-40-language-reference.html > >Let me know what you think, or if you find odd things. To be clear, I'm >not looking for feedback at the styling: I'm using the default styles of >docbook-xsltng, and I have done zero styling at this time. > >Mark > >P.S. This is not yet for general consumption, so please don't tweet or >post on Firebird News or anything like that. >-- >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