Re: [Firebird-docs] Improve TOC and searchability of Firebird Language Reference
Hi all, > So for now, let's take the most conservative approach and apply this > change to the multi-page HTML build of the refdocs set only (i.e. > LangRef and LangRefUpds) and leave everything else untouched. I've committed the changes. Cheers, Paul -- Mobile security can be enabling, not merely restricting. Employees who bring their own devices (BYOD) to work are irked by the imposition of MDM restrictions. Mobile Device Manager Plus allows you to control only the apps on BYO-devices by containerizing them, leaving personal data untouched! https://ad.doubleclick.net/ddm/clk/304595813;131938128;j ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Improve TOC and searchability of Firebird Language Reference
Hi Helen, >> PDF is very different and already has the navigation pane, so local >> ToCs are probably less useful there. However, we can do it if we want. >> I've added a PDF with chapter ToCs to the above page as an example. > > Actually, the PDF bookmarks do the job efficiently, without resorting > to sub-TOCs - "not broke, don't fix" would be a good strategy, > methinks. I agree, although I must say that chapter ToCs - not section ToCs - in the LangRef may be useful. But we can always see about that later. So for now, let's take the most conservative approach and apply this change to the multi-page HTML build of the refdocs set only (i.e. LangRef and LangRefUpds) and leave everything else untouched. Cheers, Paul -- Mobile security can be enabling, not merely restricting. Employees who bring their own devices (BYOD) to work are irked by the imposition of MDM restrictions. Mobile Device Manager Plus allows you to control only the apps on BYO-devices by containerizing them, leaving personal data untouched! https://ad.doubleclick.net/ddm/clk/304595813;131938128;j ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Improve TOC and searchability of Firebird Language Reference
Hello Paul, Wednesday, May 11, 2016, 1:03:39 AM, you wrote: > Helen wrote: > But notice that the (local) changes I made only apply to multipage HTML. > Of course we can do the same for monohtml (as you use for the rlsnotes), > but we can also leave that build as-is or make other adjustments. I've stopped using monohtml for release notes - so far, only the FB3 notes are multi-page but I have set up places in the web structure for the others, when I get around to building them. The reason for this is the lack of breadcrumbs in the monohtml. > PDF is very different and already has the navigation pane, so local > ToCs are probably less useful there. However, we can do it if we want. > I've added a PDF with chapter ToCs to the above page as an example. Actually, the PDF bookmarks do the job efficiently, without resorting to sub-TOCs - "not broke, don't fix" would be a good strategy, methinks. > I'll commit the '2-2-2' variant then for now. But shall I do it just for > the refdocs set or for all our HTML docs? It would likely make a big mess of release notes as, since v.2.0, AFAIR, the DDL and DML sections have a hard-coded "TOC" at the beginning of each of those chapters, anyway. I am loath to start mucking around with the sources of older release notes, which would put them out of synch with the translations. As for the other docs, I haven't worked with the sources of them. Perhaps Norm would like to comment. Helen -- Mobile security can be enabling, not merely restricting. Employees who bring their own devices (BYOD) to work are irked by the imposition of MDM restrictions. Mobile Device Manager Plus allows you to control only the apps on BYO-devices by containerizing them, leaving personal data untouched! https://ad.doubleclick.net/ddm/clk/304595813;131938128;j ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Improve TOC and searchability of Firebird Language Reference
Helen wrote: >> My preference would be the second variant (2 - 2 - 2), where... > I prefer the second version too. It uses a bit more real estate but > it means one doesn't have to keep reverting to the top-level TOC if > browsing for a specific function while not knowing exactly the one you > want. > > I guess time will tell, once we see the feature in action with the > whole book and in the PDF. The four HTML builds at firebird.vinkenoog.nl each comprise the entire book. But notice that the (local) changes I made only apply to multipage HTML. Of course we can do the same for monohtml (as you use for the rlsnotes), but we can also leave that build as-is or make other adjustments. PDF is very different and already has the navigation pane, so local ToCs are probably less useful there. However, we can do it if we want. I've added a PDF with chapter ToCs to the above page as an example. > Got your corrections for the BIN* functions, thanks. I will probably > defer a new build until I have the new template on board. I'll commit the '2-2-2' variant then for now. But shall I do it just for the refdocs set or for all our HTML docs? Cheers, Paul -- Mobile security can be enabling, not merely restricting. Employees who bring their own devices (BYOD) to work are irked by the imposition of MDM restrictions. Mobile Device Manager Plus allows you to control only the apps on BYO-devices by containerizing them, leaving personal data untouched! https://ad.doubleclick.net/ddm/clk/304595813;131938128;j ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] FbLangRef25 Translators & Reviewers
Helen Borrie wrote Wed, 27 Apr 2016 03:17:00 +0300: Hello, Helen I would like to say a few errors in the description of Operator Precedence. Common Language Elements->Expressions->SQL Operators->Operator Precedence 1. Arithmetic Operators. Among the arithmetic operators of places without unary plus (+) and minus (-). They have a higher priority than multiplication and division. Operator Purpose Precedence -- + Unary plus 1 - Unary minus 1 * Multiplication 2 / Division2 + Addition3 - Subtraction 3 2. Comparison Operators. All comparison operators have the same priority. Since Firebird 3.0.1. predicate IS has a higher priority than the other comparison operators. The Firebird 2.x predicate IS has the same priority as other comparison operators. Operators Priorities can be found in parse.y // precedence declarations for expression evaluation %left OR %left AND %left NOT %left '=' '<' '>' BETWEEN LIKE CONTAINING STARTING SIMILAR KW_IN NEQ GEQ LEQ NOT_GTR NOT_LSS %left IS %left '+' '-' %left '*' '/' %left UMINUS UPLUS %left CONCATENATE %left COLLATE -- Cheers, Simonov Denis -- Mobile security can be enabling, not merely restricting. Employees who bring their own devices (BYOD) to work are irked by the imposition of MDM restrictions. Mobile Device Manager Plus allows you to control only the apps on BYO-devices by containerizing them, leaving personal data untouched! https://ad.doubleclick.net/ddm/clk/304595813;131938128;j ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs