Re: [Firebird-devel] Firebird message file and use of

[Bill O. <bil...@sa...>]

That was fun! Thanks!

As Sean points out, some of these choice are arbitrary and SAS-specific. In 
our doc, we sometimes refer to DATA STEP code vs. Data Step or DATASTEP. So, 
the pubs team is trying to clean up these inconsistencies. I see our testers 
are wading through ton of diffs now in accomodating these changes.

Maybe a better exercise is to scan the Firebird message file is to see any 
cases where we spell both ways, and adopt a uniform choice. I looked over 
the message file, and suggestions are below.
http://firebird.cvs.sourceforge.net/firebird/firebird2/src/msgs/messages2.sql?view=markup&sortby=date

British spellings and Latin abbreviations.... Ok fine. :)

For recap, here were my testers preferences
ERROR: data base (Misspelled Word - use "database")
ERROR: datatype (Misspelled Word - use "data type") Note: Spell as one word 
only in the context of XML datatypes libraries, following the W3C's 
convention.
ERROR: file name (Non-standard Spelling - use "filename")
ERROR: id (Incorrect Capitalization - use "ID") Note: Do not use "id" as a 
short form of "ID" (meaning "identifiers").
ERROR: username (Incorrect Term - use "user name, User Name")

Here are the revised suggestions:
"database" with no spaces seems to be most common usage w 426 usages. 1 
usage for "data base". Please change to "database".
example: 1631 ('gfix_db_name', 'ALICE_gfix', 'alice.c', NULL, 3, 1, NULL, 
'data base file name (@1) already given', NULL, NULL);

"data type" with space at 39 usages, and "datatype" with no spaces at 21, 
although "datatype" sometimes used in constant declarations. Suggest 
"datatype" changed to "data type".

"filename" is less common w 8 usages, but "file name" has 15 usages. Suggest 
"file name" changed to "filename".

" ID " 3 occurences, and " id " 5 occurences.  Suggest usage of ID.
example:   250 ('indexnotdefined', 'set_index', 'exe.c', NULL, 0, 151, NULL, 
'there is no index in table @1 with id @2', NULL, NULL);

"user name" 15 occurences and "username" 6 occurences. Please change 
"username" to "user name".

-bill