Addding WARNING in alias/short modules

lambdalib/iolib/rtl/la_ioshort.v

@@ -1,14 +1,16 @@
 /*****************************************************************************
- * Function: Inout Port Short
+ * Function: Simulation Friendly IO Alias Module
  * Copyright: Lambda Project Authors. All rights Reserved.
  * License:  MIT (see LICENSE file in Lambda repository)
  *
  * Docs:
  *
- * Workaround for unsupported tran, alias, and port aliasing in Verilator.
+ * Instantiates the la_pt inout alias module and adds a loop breaking
+ * logic for some tools that don's support tran, alias,and port aliasing.
  *
- * Useful for making connections between ports without hard coding the
- * connection in RTL.
+ * WARNING: The port list alias features is in the verilog standard,
+ * but not well supported by open source tools. Not recommended for
+ * portable designs.
  *
  ****************************************************************************/
 module la_ioshort (inout a,
@@ -17,16 +19,12 @@ module la_ioshort (inout a,
                    );
 
 `ifdef VERILATOR
-    // Using direction to break the loop
-    assign a = ~a2b ? b : 1'bz;
-    assign b = a2b ? a : 1'bz;
+   // Using direction to break the loop
+   assign a = ~a2b ? b : 1'bz;
+   assign b = a2b ? a : 1'bz;
 `else
-    // single port pass through short/hack
     // verilog_lint: waive-start module-port
-    la_pt la_pt (
-        a,
-        b
-    );
+    la_pt la_pt (a,b);
     // verilog_lint: waive-end module-port
 `endif
 

lambdalib/iolib/rtl/la_pt.v

@@ -1,11 +1,25 @@
 
-//Solution to the short was found at the end of a conversation thread at this
-// link:
-// https://groups.google.com/g/comp.lang.verilog/c/b3-6XMA8KA4
+/**************************************************************************
+ * Function: IO Alias Module
+ * Copyright: Lambda Project Authors. All rights Reserved.
+ * License:  MIT (see LICENSE file in Lambda repository)
+ *
+ * Docs:
+ *
+ * Signal renaming and concatenation of wires doesn't work for
+ * directly connected I/O ports. One solution is to hard code the
+ * connections in the design. Another option is to pass through the
+ * name translation module shown below.
+ *
+ * WARNING: The port list alias features is in the verilog standard,
+ * but not well supported by open source tools. Not recommended for
+ * portable designs.
+ *
+ *************************************************************************/
 
 module la_pt (.io1(a),
-              .io2(a)
-              );
+              .io2(a));
 
    inout wire a;
+
 endmodule