[Firebird-docs] FbLangRef Build 0.902

2016-03-27 Thread Helen Borrie
Martin,

Is there some way you can parse those "diffs" notifications from CVS
to make them useful for your translation team's SVN?

Helen


--
Transform Data into Opportunity.
Accelerate data analysis in your applications with
Intel Data Analytics Acceleration Library.
Click to learn more.
http://pubads.g.doubleclick.net/gampad/clk?id=278785351&iu=/4140
___
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/firebird-docs


[Firebird-docs] [Firebird-checkins] manual/src/docs/refdocs/langref/fblangref25 fblangref25-commons.xml, 1.5, 1.6 fblangref25-datatypes.xml, 1.5, 1.6 fblangref25-ddl.xml, 1.9, 1.10 fblangref25-functio

2016-03-27 Thread Helen Borrie
Update of /cvsroot/firebird/manual/src/docs/refdocs/langref/fblangref25
In directory sfp-cvs-1.v30.ch3.sourceforge.com:/tmp/cvs-serv17868

Modified Files:
fblangref25-commons.xml fblangref25-datatypes.xml 
fblangref25-ddl.xml fblangref25-functions-vars.xml 
fblangref25-structure.xml fblangref25.xml 
Log Message:
Corrections and additions from reviewers Feb/Mar 2016. Translators please pick 
up details of changes in firebird-docs.

Index: fblangref25-functions-vars.xml
===
RCS file: 
/cvsroot/firebird/manual/src/docs/refdocs/langref/fblangref25/fblangref25-functions-vars.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -d -r1.4 -r1.5
--- fblangref25-functions-vars.xml  26 Jan 2016 21:01:21 -  1.4
+++ fblangref25-functions-vars.xml  27 Mar 2016 21:20:48 -  1.5
@@ -2,7 +2,7 @@
 
 
-  Built-in functions and variables
+  Built-in functions and Variables
   
   
   

Index: fblangref25-commons.xml
===
RCS file: 
/cvsroot/firebird/manual/src/docs/refdocs/langref/fblangref25/fblangref25-commons.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -d -r1.5 -r1.6
--- fblangref25-commons.xml 2 Feb 2016 21:10:21 -   1.5
+++ fblangref25-commons.xml 27 Mar 2016 21:20:47 -  1.6
@@ -5,7 +5,8 @@
   Common Language Elements
   This chapter covers the elements that are common throughout the 
implementation of the
 SQL language—the expressions that are used to 
extract and operate 
-on facts from data and the predicates that test the 
truth of those facts.
+on assertions about data and the predicates that 
test the truth of those 
+assertions.
   
 Expressions
 SQL expressions provide formal methods for evaluating, transforming 
and comparing
@@ -34,7 +35,10 @@
   
   
 Array element
-An expression may contain a reference to an 
array element
+An expression may contain a reference to an 
array member
+i.e., [s],
+where s is the subscript of the member 
in the array
+
   
   
 Arithmetic operators
@@ -81,7 +85,8 @@
   
   
 Context variable
-An internally-defined context variable
+An internally-defined context 
+variable
   
   
 Local variable
@@ -118,13 +123,13 @@
 Parentheses
 Bracket pairs (…) used to group 
expressions.
 Operations inside the parentheses are performed before operations 
outside them. When
-embedded parentheses are used, the most deeply embedded 
expressions are evaluated
-first and then the evaluations move outward through the levels of 
embedding
+nested parentheses are used, the most deeply nested expressions 
are evaluated
+first and then the evaluations move outward through the levels of 
nesting.
   
   
 COLLATE clause
-Clause applied to CHAR and VARCHAR types to 
specify the collation
-sequence to use in string comparisons
+Clause applied to CHAR and VARCHAR types to 
specify the 
+character-set-specific collation sequence to use in string 
comparisons
   
   
 NEXT VALUE FOR 
sequence
@@ -161,6 +166,54 @@
 The character set of a string constant is assumed to be the same 
as the character set of
 its destined storage.
 
+
+
+  String Constants in Hexadecimal Notation
+  From Firebird 2.5 forward, string literals can be entered in 
hexadecimal notation, 
+  so-called binary strings.  Each pair of hex digits 
defines one byte in 
+  the string. Strings entered this way will have character set 
OCTETS 
+  by default but the introducer 
+  syntax can be used to force a string to be 
interpreted as another character set.
+  
+Syntax
+
+  
+{x|X}''
+
+  >  ::=  an even number of 

+     ::=  one of 0..9, A..F, a..f
+  
+
+  
+  
+  
+Examples
+
+select x'4E657276656E' from rdb$database
+  -- returns 4E657276656E, a 6-byte 'binary' string
+
+select _ascii x'4E657276656E' from rdb$database
+  -- returns 'Nerven' (same string, now interpreted as ASCII text)
+
+select _iso8859_1 x'53E46765' from rdb$database
+  -- returns 'Säge' (4 chars, 4 bytes)
+
+select _utf8 x'53C3A46765' from rdb$database
+  -- returns 'Säge' (4 chars, 5 bytes)
+
+  
+  
+Notes
+The client interface determines how binary strings are 
displayed to the user. 
+

Re: [Firebird-docs] LangRef 2.5beta1 - a few suggestions /2

2016-03-27 Thread Aage Johansen

First, thanks to Paul for checking my suggestions.
Actually, I may have misremembered: I thought there might be pitfalls 
regarding the sign of the result.

As for BETWEEN and the others: maybe precedence is totally irrelevant 
for "comparison predicates".  I just mentioned it since "comparison 
operators" have defined precedence.


-- 
Aage J.
ps
I've spent most of Easter in hospital, and haven't really been keen on 
doing testing. Sorry about that.




On 22.03.2016 09:58, Helen Borrie wrote:
> Thursday, March 17, 2016, 12:23:40 AM, Aage wrote:
>
>
>> p.39   Number constants
>
>> For hexadecimal notation, isn't there something
>> about the sign that deserves mention here?
>> The example uses 0X0800 - the first 0 after the X does serve some 
>> purpose.
>
> Aage, do you know about that "something"?  If yes, would you write
> about it?
>> 
>
>> p.40-41
>> Table 4.4. Comparison Operator Precedence
>
>> After the table:
>> "This group also includes comparison predicates
>> BETWEEN, LIKE, CONTAINING, SIMILAR TO and others."
>
>> Could something be said about the precedence of these?
>
> Is there something to be said about it?  If you know of a precedence
> for these predicates, would you write it up?  I have not heard of it.
>
>> 
>
>> p.51 (end of first paragraph):
>> A CONTAINING search is not case-sensitive.
>
>> Maybe a comment/warning on accent-sensitivity?
>
> I think you might be the first person involved with this text who has
> day-to-day experience with data in a language with accented
> characters.  What is there to say?
>
>> 
>
> I've addressed these points to Aage because he raised them.  But
> anyone who can answer, please chip in!
>
> Helen
>
>
> --
> Transform Data into Opportunity.
> Accelerate data analysis in your applications with
> Intel Data Analytics Acceleration Library.
> Click to learn more.
> http://pubads.g.doubleclick.net/gampad/clk?id=278785351&iu=/4140
>


--
Transform Data into Opportunity.
Accelerate data analysis in your applications with
Intel Data Analytics Acceleration Library.
Click to learn more.
http://pubads.g.doubleclick.net/gampad/clk?id=278785351&iu=/4140
___
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/firebird-docs