docs: some additions to #2430

Author: hansu

docs/src/hal/basic-hal.adoc

@@ -132,7 +132,7 @@ This replaces the need to use the command newsig.
 The optional direction arrows `<=`, `=>` and `<=>` make it easier to follow the logic when reading a `net` command line and are not used by the net command.
 The direction arrows must be separated by a space from the pin names.
 
-.`net` Syntax and Example
+.Syntax and Examples of `net`
 [source,{hal}]
 ----
 net signal-name pin-name <optional arrow> <optional second pin-name>
@@ -186,7 +186,7 @@ Some components have parameters that need to be set before use.
 Parameters can be set before use or while running as needed.
 You cannot use setp on a pin that is connected to a signal.
 
-.`setp` Syntax and Example
+.Syntax and Examples of `setp`
 [source,{hal}]
 ----
 setp <pin/parameter-name> <value>
@@ -198,7 +198,7 @@ setp parport.0.pin-08-out TRUE
 
 The command `sets` sets the value of a signal.
 
-.`sets` Syntax and Example:
+.Syntax and Examples of `sets`
 [source,{hal}]
 ----
 sets <signal-name> <value>
@@ -219,7 +219,7 @@ The command `unlinkp` unlinks a pin from the connected signal.
 If no signal was connected to the pin prior running the command, nothing happens.
 The `unlinkp` command is useful for trouble shooting.
 
-.`unlinkp` Syntax and Example
+.Syntax and Examples of `unlinkp`
 [source,{hal}]
 ----
 unlinkp <pin-name>
@@ -236,7 +236,7 @@ These commands are included so older configurations will still work.
 
 The command `linksp` creates a 'connection' between a signal and one pin.
 
-.`linksp` Syntax and Example
+.Syntax and Examples of `linksp`
 [source,{hal}]
 ----
 linksp <signal-name> <pin-name>
@@ -250,7 +250,7 @@ linksp X-step parport.0.pin-02-out
 The command `linkps` creates a 'connection' between one pin and one signal.
 It is the same as `linksp` but the arguments are reversed.
 
-.`linkps` Syntax and Example
+.Syntax and Examples of `linkps`
 [source,{hal}]
 ----
 linkps <pin-name> <signal-name>
@@ -264,7 +264,7 @@ linkps parport.0.pin-02-out X-Step
 the command `newsig` creates a new HAL signal by the name _<signame>_ and the data type of _<type>_.
 Type must be 'bit', 's32', 'u32' or 'float'. Error if _<signame>_ already exists.
 
-.`newsig` Syntax and Example
+.Syntax and Examples of `newsig`
 [source,{hal}]
 ----
 newsig <signame> <type>
@@ -365,7 +365,7 @@ and2.N.in1 (bit, in)
 and2.N.out (bit, out)
 ----
 
-.`and2` Truth Table
+.Truth Table of `and2`
 [width="90%",options="header"]
 |===
 |in0   | in1   | out
@@ -397,7 +397,7 @@ not.n.in (bit, in)
 not.n.out (bit, out)
 ----
 
-.`not` Truth Table
+.Truth Table of `not`
 [width="90%",options="header"]
 |===
 |in    | out
@@ -472,7 +472,7 @@ xor2.n.out (bit, out)
 [[sec:hal-logic-examples]]
 == Logic Examples(((HAL Logic Examples)))
 
-.`and2` example connecting two inputs to one output
+.Example using `and2`
 [source,{hal}]
 ----
 loadrt and2 count=1
@@ -499,7 +499,7 @@ The conversion is the sum of the 'weights' of the bits present plus any offset.
 It's similar to 'binary coded decimal' but with more options.
 The 'hold' bit interrupts the input processing, so that the 'sum' value no longer changes.
 
-.weighted_sum component loading syntax
+.Syntax for loading component `weighted_sum`
 [source,{hal}]
 ----
 loadrt weighted_sum wsum_sizes=size[,size,...]
@@ -509,7 +509,7 @@ Creates groups of ``weighted_sum``s, each with the given number of input bits (s
 
 To update the `weighted_sum`, the `process_wsums` must be attached to a thread.
 
-.add `process_wsums` function
+.Add `process_wsums` to servo thread
 [source,{hal}]
 ----
 addf process_wsums servo-thread
@@ -520,7 +520,7 @@ Which updates the `weighted_sum` component.
 In the following example, a copy of the AXIS HAL configuration window, bits '0' and '2' are TRUE, they have no offset.
 The weight ('weight') of bit 0 is 1, that of bit 2 is 4, so the sum is 5.
 
-.`weighted_sum` Example component Pin for weighted sums.
+.Component pins of `weighted_sum`
 [width="90%",options="header"]
 |===
 |Owner |Type |Dir  |Value |Name