lm32: fix documentation style

Signed-off-by: Michael Walle <michael@walle.cc>

verilog/lm32/lm32_dp_ram.v

@@ -1,14 +1,29 @@
+/////////////////////////////////////////////////////
+// Module interface
+/////////////////////////////////////////////////////
+
 module lm32_dp_ram(
+	// ----- Inputs -----
 	clk_i,
 	rst_i,
 	we_i,
 	waddr_i,
 	wdata_i,
 	raddr_i,
-	rdata_o);
+	// ----- Outputs -----
+	rdata_o
+);
 
-parameter addr_width = 32;
-parameter data_width = 8;
+/////////////////////////////////////////////////////
+// Parameters
+/////////////////////////////////////////////////////
+
+parameter data_width = 1;               // Width of the data ports
+parameter addr_width = 1;               // Width of the address ports
+
+/////////////////////////////////////////////////////
+// Inputs
+/////////////////////////////////////////////////////
 
 input clk_i;
 input rst_i;
@@ -16,14 +31,31 @@ input we_i;
 input [addr_width-1:0] waddr_i;
 input [data_width-1:0] wdata_i;
 input [addr_width-1:0] raddr_i;
+
+/////////////////////////////////////////////////////
+// Outputs
+/////////////////////////////////////////////////////
+
 output [data_width-1:0] rdata_o;
 
-reg [data_width-1:0] mem[(1<<addr_width)-1:0];
+/////////////////////////////////////////////////////
+// Internal nets and registers
+/////////////////////////////////////////////////////
 
+reg [data_width-1:0] mem[(1<<addr_width)-1:0];
 reg [addr_width-1:0] raddr_r;
+
+/////////////////////////////////////////////////////
+// Combinational logic
+/////////////////////////////////////////////////////
+
 assign rdata_o = mem[raddr_r];
 
-always @ (posedge clk_i)
+/////////////////////////////////////////////////////
+// Sequential logic
+/////////////////////////////////////////////////////
+
+always @(posedge clk_i)
 begin
 	if (we_i)
 		mem[waddr_i] <= wdata_i;