glossary: some fixes, unify style, streamline language

Fix A5 description concerning A5/2 (not in use).
Fix UICC: 'Circuit Card', not 'Chip Circuit', and replace 'FIXME'.
NITB: like OsmoNITB just without Osmo, reference OsmoNITB.

Add some words/explanations (FPGA, MSC, OXCO, UICC, VTY).

Fix minor typos ('Freee', 'usees', over-eager dashes '-',
capitalisation).
Use 'an' before acronyms pronounced starting with a vocal ('S', 'M').
Use 'a' before 'U'.

Unify style:
Use semicoli ';' instead of periods '.' or commas ',' where appropriate.
Use lower case letters after semicoli.

1 files changed, 59 insertions, 54 deletions

diff --git a/common/chapters/glossary.adoc b/common/chapters/glossary.adoc
index 2a6ce89..14c65f5 100644
--- a/common/chapters/glossary.adoc
+++ b/common/chapters/glossary.adoc
@@ -8,10 +8,10 @@ A Interface::
   <<3gpp-ts-48-008>>)
 A3/A8::
   Algorithm 3 and 8; Authentication and key generation algorithm in GSM
-  and GPRS. COMP128v1/v2/v3 or MILENAGE are typically used
+  and GPRS, typically COMP128v1/v2/v3 or MILENAGE are typically used
 A5::
   Algorithm 5; Air-interface encryption of GSM; currently only A5/0
-  through A5/3 are in use
+  (no encryption), A5/1 and A5/3 are in use
 Abis Interface::
   Interface between BTS and BSC, traditionally over E1 (_3GPP TS 48.058_
   <<3gpp-ts-48-058>> and _3GPP TS 52.021_ <<3gpp-ts-52-021>>)
@@ -19,10 +19,10 @@ AGCH::
   Access Grant Channel on Um interface; used to assign a dedicated
   channel in response to RACH request
 AGPL::
-  GNU Affero General Public License, a copyleft-style Freee Software License
+  GNU Affero General Public License, a copyleft-style Free Software License
 ARFCN::
-  Absolute Radio Frequency Channel Number, specifying a tuple of uplink
-  and downlink frequency
+  Absolute Radio Frequency Channel Number; specifies a tuple of uplink
+  and downlink frequencies
 AUC::
   Authentication Center; central database of authentication key material
   for each subscriber
@@ -52,7 +52,7 @@ Cell::
   A cell in a cellular network, served by a BTS
 CEPT::
   Conférence européenne des administrations des postes et des
-  télécommunications; European onference of Postal and Telecommunications
+  télécommunications; European Conference of Postal and Telecommunications
   Administrations.
 CGI::
   Cell Global Identifier comprised of MCC, MNC, LAC and BSIC
@@ -76,18 +76,18 @@ EDGE::
 EGPRS::
   Enhanced GPRS; the part of EDGE relating to GPRS services
 ESME::
-  External SMS Entity.  An external application interfacing with a SMSC
+  External SMS Entity; an external application interfacing with a SMSC
   over SMPP
 ETSI::
   European Telecommunications Standardization Institute
 FPGA::
-  Field Programmable Gate Array. Programmable digital logic
+  Field Programmable Gate Array; programmable digital logic hardware
 Gb::
   Interface between PCU and SGSN in GPRS/EDGE network; uses NS, BSSGP, LLC
 GERAN::
   GPRS/EDGE Radio Access Network
 GFDL::
-  GNU Free Documentation License, a copyleft-style Documentation License
+  GNU Free Documentation License; a copyleft-style Documentation License
 GGSN::
   GPRS Gateway Support Node; gateway between GPRS and external (IP) network
 GMSK::
@@ -95,16 +95,16 @@ GMSK::
 GPL::
   GNU General Public License, a copyleft-style Freee Software License
 Gp::
-  Gp interface between SGSN and GGSN; usees GTP protocol
+  Gp interface between SGSN and GGSN; uses GTP protocol
 GPS::
-  Global Positioning System.  Provides a high accuracy clock reference
-  next to position.
+  Global Positioning System; provides a highly accurate clock reference
+  besides the global position
 GSM::
   Global System for Mobile Communications.  ETSI/3GPP Standard of a 2G
   digital cellular network
 GSMTAP::
-  GSM tap. Pseudo-Standard for encapsulating GSM protocol layers over
-  UDP/IP for means of analysis
+  GSM tap; pseudo standard for encapsulating GSM protocol layers over
+  UDP/IP for analysis
 GTP::
   GPRS Tunnel Protocol; used between SGSN and GGSN
 HLR::
@@ -117,11 +117,11 @@ IMEI::
   International Mobile Equipment Identity; unique identifier for the mobile phone
 IMSI::
   International Mobile Subscriber Identity; 15-digit unique identifier
-  for the subscriber/SIM, starts with MCC/MNC of issuing operator
+  for the subscriber/SIM; starts with MCC/MNC of issuing operator
 IP::
   Internet Protocol (_IETF RFC 791_ <<ietf-rfc791>>)
 IPA::
-  The _ip.access GSM over IP_ protocol, used to multiplex a single TCP connection
+  _ip.access GSM over IP_ protocol; used to multiplex a single TCP connection
 LAC::
   Location Area Code; 16bit identifier of Location Area within network
 LAPD::
@@ -138,15 +138,16 @@ MCC::
 MGW::
   Media Gateway
 MM::
-  Mobility Management; Part of the GSM Layer 3 Protocol
+  Mobility Management; part of the GSM Layer 3 Protocol
 MNC::
   Mobile Network Code; identifies network within a country; assigned by national regulator
 MNO::
-  Mobile Network Operator; Operator with real physical radio network under his MCC/MNC
+  Mobile Network Operator; operator with physical radio network under his MCC/MNC
 MS::
-  Mobile Station, the mobile phone / GSM Modem
+  Mobile Station; a mobile phone / GSM Modem
 MSC::
-  Mobile Switching Center
+  Mobile Switching Center; network element in the circuit-switcehd
+  core network
 MSISDN::
   Mobile Subscriber ISDN Number; telephone number of the subscriber
 MVNO::
@@ -154,7 +155,8 @@ MVNO::
 NCC::
   Network Color Code; assigned by national regulator
 NITB::
-  Network In The Box; integrating BSC,MSC,VLR,HLR,SMSC functions
+  Network In The Box; combines functionality traditionally proivided
+  by BSC, MSC, VLR, HLR, SMSC functions; see OsmoNITB
 NSEI::
   NS Entity Identifier
 NVCI::
@@ -164,7 +166,8 @@ NWL::
 NS::
   Network Service; protocol on Gb interface (_3GPP TS 48.016_ <<3gpp-ts-48-016>>)
 OCXO::
-  Oven Controlled Crystal Oscillator.  A very high-precision oscillator.
+  Oven Controlled Crystal Oscillator; very high precision oscillator,
+  superior to a VCTCXO
 OML::
   Operation & Maintenance Link (ETSI/_3GPP TS 52.021_ <<3gpp-ts-52-021>>)
 OpenBSC::
@@ -172,22 +175,23 @@ OpenBSC::
 OpenGGSN::
   Open Source implementation of a GPRS Packet Control Unit
 OpenVPN::
-  Open-Source Virtual Private Network.  Used to establish encrypted private networks over untrusted public networks.
+  Open-Source Virtual Private Network;  software employed to establish
+  encrypted private networks over untrusted public networks
 Osmocom::
-  Open Source MObile COMmunications; Collaborative community for
+  Open Source MObile COMmunications; collaborative community for
   implementing communications protocols and systems, including GSM, GPRS,
   TETRA, DECT, GMR and others
 OsmoBSC::
   Open Source implementation of a GSM Base Station Controller
 OsmoNITB::
-  Open Source implementation of a GSM Network In The Box, comprising
-  functionality that traditionally required BSC, MSC, VLR, HLR, AUC, SMSC
+  Open Source implementation of a GSM Network In The Box, combines
+  functionality traditionally provided by  BSC, MSC, VLR, HLR, AUC, SMSC
 OsmoSGSN::
   Open Source implementation of a Serving GPRS Support Node
 OsmoPCU::
   Open Source implementation of a GPRS Packet Control Unit
 PCH::
-  Paging Channel on downlink Um interface; used by network to page a MS
+  Paging Channel on downlink Um interface; used by network to page an MS
 PCU::
   Packet Control Unit; used to manage Layer 2 of the GPRS radio interface
 PDCH::
@@ -200,11 +204,11 @@ RACH::
   Random Access Channel on uplink Um interface; used by MS to request
   establishment of a dedicated channel
 RF::
-  Radio Frequency (synonymous to transceiver equipment, e.g. being on or off)
+  Radio Frequency
 Roaming::
   Procedure in which a subscriber of one network is using the radio
-  network of another network, often in different countries, but national
-  roaming exists in some countries, too
+  network of another network, often in different countries; in some
+  countris national roaming exists
 Routing Area::
   Routing Area; GPRS specific sub-division of Location Area
 RR::
@@ -212,7 +216,7 @@ RR::
 RSL::
   Radio Signalling Link (_3GPP TS 48.058_ <<3gpp-ts-48-058>>)
 RTP::
-  Real-Time Transport Protocol (_IETF RFC 3550_ <<ietf-rfc3550>>). Used to
+  Real-Time Transport Protocol (_IETF RFC 3550_ <<ietf-rfc3550>>); Used to
   transport audio/video streams over UDP/IP
 SACCH::
   Slow Associate Control Channel on Um interface; bundled to a TCH or
@@ -225,55 +229,56 @@ SDK::
 SIM::
   Subscriber Identity Module; small chip card storing subscriber identity
 Site::
-  A site is a location where one or multiple BTSs are installed,
-  typically three BTS for three sectors
+  A site is a location where one or more BTSs are installed,
+  typically three BTSs for three sectors
 SMPP::
-  Short Message Peer-to-Peer; TCP based protocol how external entities
-  can interface with SMSC
+  Short Message Peer-to-Peer; TCP based protocol to interface external
+  entities with an SMSC
 SMSC::
-  Short Message Service Center; Store-and-forward relay for short messages
+  Short Message Service Center; store-and-forward relay for short messages
 SSH::
-  Secure Shell, _IETF RFC 4250_ <<ietf-rfc4251>> to 4254
+  Secure Shell; _IETF RFC 4250_ <<ietf-rfc4251>> to 4254
 syslog::
   System logging service of UNIX-like operating systems
 System Information::
   A set of downlink messages on the BCCH and SACCH of the Um interface
   describing properties of the cell and network
 TCH::
-  Traffic Channel, used for circuit-switched user traffic (mostly voice)
+  Traffic Channel; used for circuit-switched user traffic (mostly voice)
   in GSM
 TCP::
-  Transmission Control Protocol (_IETF RFC 793_ <<ietf-rfc793>>)
+  Transmission Control Protocol; (_IETF RFC 793_ <<ietf-rfc793>>)
 TFTP::
-  Trivial File Transfer Protocol (_IETF RFC 1350_ <<ietf-rfc1350>>)
+  Trivial File Transfer Protocol; (_IETF RFC 1350_ <<ietf-rfc1350>>)
 TRX::
-  Transceiver; Element of a BTS serving a single carrier
+  Transceiver; element of a BTS serving a single carrier
 u-Boot::
-  The name of a boot loader used in a lot of embedded systems
+  Boot loader used in various embedded systems
 UBI::
-  A MTD wear leveling system to deal with NAND flash in Linux
+  An MTD wear leveling system to deal with NAND flash in Linux
 UBL::
-  The name for the initial bootloader loaded by the TI Davinci SoC
+  Initial bootloader loaded by the TI Davinci SoC
 UDP::
   User Datagram Protocol (_IETF RFC 768_ <<ietf-rfc768>>)
 UICC::
-  Universal Integrated Chip Circuit.  A smart card according to _ETSI
+  Universal Integrated Chip Card;  A smart card according to _ETSI
   TR 102 216_ <<etsi-tr102216>>
 Um interface::
   U mobile; Radio interface between MS and BTS
 uplink::
-  Direction of messages / signals from the mobile phone towards the network
+  Direction of messages: Signals from the mobile phone towards the network
 USIM::
-  Universal Subscriber Identity Module; Application running on an UICC
-  to provide subscriber identity for UMTS and GSM networks.
+  Universal Subscriber Identity Module; application running on a UICC
+  to provide subscriber identity for UMTS and GSM networks
 VCTCXO::
-  Voltage Controlled, Temperature Compensated Crystal Oscillator.  A
-  precision oscillator, better than a classic Crystal Oscillator, but
-  inferior to an OCXO.
+  Voltage Controlled, Temperature Compensated Crystal Oscillator;  a
+  precision oscillator, superior to a classic crystal oscillator, but
+  inferior to an OCXO
 VPLMN::
   Visited PLMN; the network in which the subscriber is currently
-  registered. May differ from HPLMN when on roaming.
+  registered; may differ from HPLMN when on roaming
 VTY::
-  Virtual TeletYpe. A textual command-line interface for configuration
-  and introspection.
+  Virtual TeletYpe; a textual command-line interface for configuration
+  and introspection, e.g. the OsmoBSC configuration file as well as
+  its telnet link on port 4242