Rework documentation

Make documentation interleaved with the code. Use rst files
within various libraries.

Author: nipo

doc/img/axis_buffer2.drawio.svg

@@ -20,4 +20,6 @@ backend-agnostic implementations.
    nsl_clocking/index
    nsl_io/index
    nsl_color/index
+   nsl_event/index
    debug
+   network

doc/img/axis_buffer2.svg

@@ -34,6 +34,6 @@ Custom On-chip Communication Framework
 --------------------------------------
 
 Before implementing high-end standard interconnects, NSL had the need
-for an efficient communication framework. `bnoc`_ is a set of 8-bit
+for an efficient communication framework. `bnoc <bnoc/index>`_ is a set of 8-bit
 wide data streaming infrastructure models, with various features
 depending on the needs.

doc/img/axis_packer.drawio.svg

@@ -0,0 +1,9 @@
+===============
+ Network stack
+===============
+
+.. toctree::
+
+   nsl_smi/index
+   nsl_mii/index
+   nsl_inet/index

doc/img/axis_packer.svg

@@ -13,7 +13,7 @@ older).
 Configuration for APB is held in ``config_t`` record type. It holds the
 follwing settings:
 
-* Address, data, *user,
+* Address, data, \*user,
 * prot, rme, strb, ready, err and wakeup fields availability.
 
 ``config()`` function can generate such a configuration yet ensuring it

lib/index.rst

@@ -251,8 +251,6 @@ interfaces.
   synchronous interface to backend access in terms of read and write
   channel, non concurrent.
 
-  .. vhdl:symbol:: nsl_amba.axi4_mm.axi4_mm_lite_slave
-
 * :vhdl:component:`nsl_amba.axi4_mm.axi4_mm_lite_regmap` is
   abstracting even more as it:
 

lib/interconnect.rst

@@ -265,6 +265,7 @@ package axi4_stream is
       out_o : out master_t;
       out_i : in slave_t
       );
+    --@-- grouped name:in_, members:in_i;in_o
   end component;
 
   -- This extracts a header of fixed size from the stream. Header is