gb: Some language improvements, formatting changes
diff --git a/doc/manuals/gb/bssgp.adoc b/doc/manuals/gb/bssgp.adoc
index 6afd820..bb9da43 100644
--- a/doc/manuals/gb/bssgp.adoc
+++ b/doc/manuals/gb/bssgp.adoc
@@ -3,8 +3,8 @@
=== List of Messages
-The following tables list the BSSGP messages used by OsmoPCU, grouped by their
-level of compliance with 3GPP TS 08.18.
+The following tables list the BSSGP messages used by OsmoPCU, grouped
+by their level of compliance with 3GPP TS 08.18.
==== Messages Compliant With TS 08.18
@@ -78,8 +78,11 @@
[[dl_unit_data]]
==== DL-UNITDATA
-This message conforms to 3GPP TS 08.18 § 10.2.1, with the following limitations: OsmoPCU does not support QoS,
-all optional IEs except for IMSI and old TLLI are ignored.
+This message conforms to 3GPP TS 08.18 § 10.2.1, with the following
+limitations:
+
+* OsmoPCU does not support QoS
+* all optional IEs except for IMSI and old TLLI are ignored.
._DL-UNITDATA_ IE limitations
[options="header",cols="10%,30%,60%"]
@@ -98,8 +101,10 @@
==== UL-UNITDATA
This message conforms to 3GPP TS 08.18 § 10.2.2, with the following limitations:
-OsmoPCU does not send optional IEs - PFI (§ 12.3.42) and LSA Identifier List (§ 11.3.18).
-QoS Profile (§ 11.3.28) IE is always set to 0x04.
+
+* OsmoPCU does not send optional IEs - PFI (§ 12.3.42) and LSA
+ Identifier List (§ 11.3.18).
+* QoS Profile (§ 11.3.28) IE is always set to 0x04.
[[ra_capab]]
==== RA-CAPABILITY
@@ -109,8 +114,10 @@
[[paging_ps]]
==== PAGING PS
-This message conforms to 3GPP TS 08.18 § 10.3.1, with the following limitations:
-only IMSI and P-TMSI are parsed by OsmoPCU.
+This message conforms to 3GPP TS 08.18 § 10.3.1, with the following
+limitations:
+
+* only IMSI and P-TMSI are parsed by OsmoPCU.
._DL-UNITDATA_ IE limitations
[options="header",cols="10%,30%,60%"]
@@ -121,7 +128,7 @@
| 11.3.17 | Location Are | _ignored_
| 11.3.31 | Routeing Area | _ignored_
| 11.3.3 | BSS Area Indication | _ignored_
-| 1.3.42 | PFI | _ignored_
+| 11.3.42 | PFI | _ignored_
| 11.3.43 | ABQP | _ignored_
| 11.3.28 | QoS Profile | _ignored_
| 11.3.36 | P-TMSI | treated as mandatory (in case of absence paging with 0-length P-TMSI will be sent)
@@ -131,83 +138,103 @@
[[paging_cs]]
==== PAGING CS
-This message is received and logged but ignored by OsmoPCU at the moment.
+This message is received and logged but ignored by OsmoPCU at the
+moment.
[[susp_ack]]
==== SUSPEND-ACK
-This message is received and logged but ignored by OsmoPCU at the moment.
+This message is received and logged but ignored by OsmoPCU at the
+moment.
[[susp_nack]]
==== SUSPEND-NACK
-This message is received and logged but ignored by OsmoPCU at the moment.
+This message is received and logged but ignored by OsmoPCU at the
+moment.
[[res_ack]]
==== RESUME-ACK
-This message is received and logged but ignored by OsmoPCU at the moment.
+This message is received and logged but ignored by OsmoPCU at the
+moment.
[[res_nack]]
==== RESUME-NACK
-This message is received and logged but ignored by OsmoPCU at the moment.
+This message is received and logged but ignored by OsmoPCU at the
+moment.
[[block_ack]]
==== BVC-BLOCK-ACK
-This message is received and logged but ignored by OsmoPCU at the moment.
+This message is received and logged but ignored by OsmoPCU at the
+moment.
[[bvc_reset]]
==== BVC-RESET
-OsmoPCU never transmits optional Feature bitmap (3GPP TS 08.18 § 11.3.40) IE.
-Receiving BVC RESET will cause OsmoPCU to respond with "Unknown BVCI" status message.
+OsmoPCU never transmits optional Feature bitmap (3GPP TS 08.18 §
+11.3.40) IE.
+
+Receiving BVC RESET will cause OsmoPCU to respond with "Unknown BVCI"
+status message.
[[reset_ack]]
==== BVC-RESET-ACK
This message conforms to 3GPP TS 08.18 § 10.4.13.
-After receiving it OsmoPCU completes the RESET procedure for BVC according to 3GPP TS 08.18 § 8.4.
+
+After receiving it OsmoPCU completes the RESET procedure for BVC
+according to 3GPP TS 08.18 § 8.4.
[[unblock_ack]]
==== BVC-UNBLOCK-ACK
This message conforms to 3GPP TS 08.18 § 10.4.11.
-After receiving it OsmoPCU completes the RESET procedure for BVC according to 3GPP TS 08.18 § 8.3.
+
+After receiving it OsmoPCU completes the RESET procedure for BVC
+according to 3GPP TS 08.18 § 8.3.
[[bvc_unblock]]
==== BVC-UNBLOCK
-This message conforms to 3GPP TS 08.18 § 10.4.10 and is send by OsmoPCU as part of UNBLOCK procedure
-described in 3GPP TS 08.18 § 8.3.
+This message conforms to 3GPP TS 08.18 § 10.4.10 and is send by
+OsmoPCU as part of UNBLOCK procedure described in 3GPP TS 08.18 § 8.3.
[[flow_ms_ack]]
==== FLOW-CONTROL-MS-ACK
-This message is received and logged but ignored by OsmoPCU at the moment.
+This message is received and logged but ignored by OsmoPCU at the
+moment.
[[flow_bvc_ack]]
==== FLOW-CONTROL-BVC-ACK
-This message is received and logged but ignored by OsmoPCU at the moment.
+This message is received and logged but ignored by OsmoPCU at the
+moment.
[[flow_bvc]]
==== FLOW-CONTROL-BVC
-This message conforms to 3GPP TS 08.18 § 10.4.4, with the following limitations:
-OsmoPCU does not support Current Bucket Level (CBL) feature so Bucket_Full Ratio (TS 08.18 § 11.3.46) IE
-is not transmitted as part of this message.
+This message conforms to 3GPP TS 08.18 § 10.4.4, with the following
+limitations:
+
+* OsmoPCU does not support Current Bucket Level (CBL) feature so
+ Bucket_Full Ratio (TS 08.18 § 11.3.46) IE is not transmitted as part
+ of this message.
[[flush_ll]]
==== FLUSH-LL
-This message is received and logged but ignored by OsmoPCU at the moment.
+This message is received and logged but ignored by OsmoPCU at the
+moment.
[[invoke_trace]]
==== SGSN-INVOKE-TRACE
-This message is received and logged but ignored by OsmoPCU at the moment.
+This message is received and logged but ignored by OsmoPCU at the
+moment.
[[bssgp_status]]
==== STATUS
@@ -216,13 +243,13 @@
=== Information Elements Overview
-All of the IEs handled by OsmoPCU are listed below, with limitations and
-additions to TS 08.18 specified in more detail.
+All of the IEs handled by OsmoPCU are listed below, with limitations
+and additions to TS 08.18 specified in more detail.
==== IEs Conforming to TS 08.18
-The following Information Elements are accepted by OsmoPCU. Not all IEs are
-actually evaluated.
+The following Information Elements are accepted by OsmoPCU. Not all
+IEs are actually evaluated.
.IEs conforming to TS 08.18
[options="header",cols="5%,10%,40%,5%,40%"]
@@ -295,8 +322,8 @@
==== Bucket Leak Rate
-The value used by OsmoPCU for this IE can be set through configuration file or vty via
-"flow-control force-ms-leak-rate <1-6553500>" command.
+The value used by OsmoPCU for this IE can be set through configuration
+file or vty via "flow-control force-ms-leak-rate <1-6553500>" command.
==== BVC Bucket Size
@@ -305,7 +332,8 @@
==== Channel needed
-This IE is ignored because entire message which contains it is ignored by OsmoPCU - see <<paging_cs>> for details.
+This IE is ignored because entire message which contains it is ignored
+by OsmoPCU - see <<paging_cs>> for details.
==== DRX Parameters
@@ -313,16 +341,19 @@
==== eMLPP-Priority
-This IE is ignored because entire message which contains it is ignored by OsmoPCU - see <<paging_cs>> for details.
+This IE is ignored because entire message which contains it is ignored
+by OsmoPCU - see <<paging_cs>> for details.
==== Flush Action
-This IE is ignored because entire message which contains it is ignored by OsmoPCU - see <<flush_ll>> for details.
+This IE is ignored because entire message which contains it is ignored
+by OsmoPCU - see <<flush_ll>> for details.
==== LLC Frames Discarded
-This IE is not available because entire message which contains it (LLC-DISCARDED) is not implemented by
-OsmoPCU - see for <<not_impl>> details.
+This IE is not available because entire message which contains it
+(LLC-DISCARDED) is not implemented by OsmoPCU - see for <<not_impl>>
+details.
==== Location Area
@@ -330,12 +361,14 @@
==== Mobile Id
-This IE is ignored because entire message which contains it is ignored by OsmoPCU - see <<invoke_trace>> for details.
+This IE is ignored because entire message which contains it is ignored
+by OsmoPCU - see <<invoke_trace>> for details.
==== MS Bucket Size
-The value used by OsmoPCU for this IE can be set through configuration file or vty via
-"flow-control force-ms-bucket-size <1-6553500>" command.
+The value used by OsmoPCU for this IE can be set through configuration
+file or vty via "flow-control force-ms-bucket-size <1-6553500>"
+command.
==== MS Radio Access Capability
@@ -343,7 +376,8 @@
==== OMC Id
-This IE is ignored because entire message which contains it is ignored by OsmoPCU - see <<invoke_trace>> for details.
+This IE is ignored because entire message which contains it is ignored
+by OsmoPCU - see <<invoke_trace>> for details.
==== Priority
@@ -351,52 +385,65 @@
==== QoS Profile
-No QoS is supported by OsmoPCU so this IE is ignored or safe default used when mandatory.
+No QoS is supported by OsmoPCU so this IE is ignored or safe default
+used when mandatory.
==== Radio Cause
-This IE is not available because entire message which contains it (RADIO-STATUS) is not implemented by
-OsmoPCU - see for <<not_impl>> details.
+This IE is not available because entire message which contains it
+(RADIO-STATUS) is not implemented by OsmoPCU - see for <<not_impl>>
+details.
==== RA-Cap-UPD-Cause
-This IE is not available because entire message which contains it (RA-CAPABILITY-UPDATE-ACK) is not implemented by
-OsmoPCU - see for <<not_impl>> details.
+This IE is not available because entire message which contains it
+(RA-CAPABILITY-UPDATE-ACK) is not implemented by OsmoPCU - see for
+<<not_impl>> details.
==== Routeing Area
This IE is ignored by OsmoPCU upon receiving.
-The messages which might require this IE to be send are not implemented by OsmoPCU - see for <<not_impl>> details.
+
+The messages which might require this IE to be send are not
+implemented by OsmoPCU - see for <<not_impl>> details.
==== Suspend Reference Number
This IE is ignored by OsmoPCU upon receiving.
-The messages which might require this IE to be send are not implemented by OsmoPCU - see for <<not_impl>> details.
+
+The messages which might require this IE to be send are not
+implemented by OsmoPCU - see for <<not_impl>> details.
==== Tag
-This IE currently only used by OsmoPCU for Flow Control procedure (TS 08.18 § 8.2). In other cases it's either ignored or unavailable.
+This IE currently only used by OsmoPCU for Flow Control procedure (TS
+08.18 § 8.2). In other cases it's either ignored or unavailable.
==== Trace Reference
-This IE is ignored because entire message which contains it is ignored by OsmoPCU - see <<invoke_trace>> for details.
+This IE is ignored because entire message which contains it is ignored
+by OsmoPCU - see <<invoke_trace>> for details.
==== Trace Type
-This IE is ignored because entire message which contains it is ignored by OsmoPCU - see <<invoke_trace>> for details.
+This IE is ignored because entire message which contains it is ignored
+by OsmoPCU - see <<invoke_trace>> for details.
==== TransactionId
-This IE is ignored because entire message which contains it is ignored by OsmoPCU - see <<invoke_trace>> for details.
+This IE is ignored because entire message which contains it is ignored
+by OsmoPCU - see <<invoke_trace>> for details.
==== Trigger Id
-This IE is ignored because entire message which contains it is ignored by OsmoPCU - see <<invoke_trace>> for details.
+This IE is ignored because entire message which contains it is ignored
+by OsmoPCU - see <<invoke_trace>> for details.
==== Number of octets affected
-This IE is not available because the messages which contains it (FLUSH-LL-ACK and LLC-DISCARDE) are not implemented by
-OsmoPCU - see for <<not_impl>> details.
+This IE is not available because the messages which contains it
+(FLUSH-LL-ACK and LLC-DISCARDE) are not implemented by OsmoPCU - see
+for <<not_impl>> details.
==== LSA Information
@@ -409,18 +456,25 @@
==== Packet Flow Identifier
This IE is ignored by OsmoPCU upon receiving.
-The messages which might require this IE to be send are not implemented by OsmoPCU - see for <<not_impl>> details.
+
+The messages which might require this IE to be send are not
+implemented by OsmoPCU - see for <<not_impl>> details.
==== Aggregate BSS QoS Profile (ABQP)
This IE is ignored by OsmoPCU upon receiving.
-The messages which might require this IE to be send are not implemented by OsmoPCU - see for <<not_impl>> details.
+
+The messages which might require this IE to be send are not
+implemented by OsmoPCU - see for <<not_impl>> details.
==== Feature Bitmap
This IE is not implemented by OsmoPCU.
+
This IE is ignored by OsmoPCU when received.
-Absence of Feature Bitmap automatically disables optional features for Network Service Entity (NSE) communicating with OsmoPCU.
+
+Absence of Feature Bitmap automatically disables optional features for
+Network Service Entity (NSE) communicating with OsmoPCU.
==== Bucket_Full Ratio
@@ -432,9 +486,16 @@
=== Gb BSSGP Initialization / PCU bring-up
-The BSSGP initialization directly follows NS connection establishment described in <<ns_init>>.
-OsmoPCU allocates BVC context for BVCI given by OsmoBTS which in turn gets it from OpenBSC.
-In addition to BVCI identifying OsmoPCU side of BSSGP connection there is also special BVCI which is accepted by OsmoPCU
-in accordance with TS 08.18 § 5.4.1: BVCI = 0 represents signaling data between SGSN and PCU in contrast
-to PTP (Peer-To-Peer) user's data.
-The mapping between BSSGP PDUs and signaling or PTP BVCIs is available in TS 08.18 Table 5.4.
+The BSSGP initialization directly follows NS connection establishment
+described in <<ns_init>>.
+
+OsmoPCU allocates a BVC context for the BVCI given by OsmoBTS, which
+in turn receives it from OpenBSC via OML procedures.
+
+In addition to the BVCI identifying the OsmoPCU side of BSSGP
+connection, there is also special BVCI which is accepted by OsmoPCU in
+accordance with TS 08.18 § 5.4.1: BVCI = 0 represents signaling data
+between SGSN and PCU in contrast to PTP (Peer-To-Peer) user's data.
+
+The mapping between BSSGP PDUs and signaling or PTP BVCIs is available
+in TS 08.18 Table 5.4.