diff --git a/libraries/base/reorder/hdllib.cfg b/libraries/base/reorder/hdllib.cfg
index 5ca2d878af2ffa44d6ee9d79af58536e7993bb19..2f5353878ee6356ca89876905375690e860d7c0e 100644
--- a/libraries/base/reorder/hdllib.cfg
+++ b/libraries/base/reorder/hdllib.cfg
@@ -4,6 +4,33 @@ hdl_lib_uses_synth = common dp
 hdl_lib_uses_sim = io_ddr tech_ddr
 hdl_lib_technology = 
 
+# Description: see doc/ss_parallel.pdf
+#
+# Remarks:
+# * Old files, with ss = subband select prefix, from LOFAR1 and Apertif
+#   mentioned in doc/ss_parallel.pdf have been renamed as follows:
+#   ss_reorder.vhd  --> reorder_row.vhd
+#   ss.vhd          --> reorder_col.vhd
+#   ss_parallel.vhd --> reorder_matrix.vhd
+#   ss_wide.vhd     --> reorder_col_wide.vhd
+#   ss_retrieve.vhd --> reorder_retreive.vhd
+#   ss_store.vhd    --> reorder_store.vhd
+#
+# * The reorder_col_wide_select.vhd and reorder_row_select.vhd are similar to
+#   reorder_col_wide.vhd and reorder_row.vhd, except that they use direct
+#   select signals instead of selection via an MM interface.
+#
+# * The reorder_row_select.vhd is similar to reorder_rewire that was used
+#   in Apertif. For new designs reorder_row_select.vhd is preferred.
+#
+# * The reorder_transpose.vhd uses the reorder_col for pretranspose in time
+#   and reorder_sequencer.vhd for transpose in external memory. Therefore
+#   the tb_reorder_transpose.vhd test bench uses io_ddr. The
+#   reorder_transpose.vhd was used in Apertif. For new designs it can serve
+#   as an example for implementing a transpose (corner turn) using external
+#   DDR memory.
+#
+
 synth_files =
     src/vhdl/reorder_pkg.vhd    
     src/vhdl/reorder_retreive.vhd
@@ -21,14 +48,6 @@ synth_files =
     src/vhdl/reorder_rewire_reg.vhd
     src/vhdl/mms_reorder_rewire.vhd
 
-# Old files should be renamed as follows in near future: 
-# ss_reorder.vhd  --> reorder_row.vhd
-# ss.vhd          --> reorder_col.vhd
-# ss_parallel.vhd --> reorder_matrix.vhd
-# ss_wide.vhd     --> reorder_col_wide.vhd
-# ss_retrieve.vhd --> reorder_retreive.vhd
-# ss_store.vhd    --> reorder_store.vhd
-    
 test_bench_files = 
     tb/vhdl/tb_reorder_transpose.vhd
     tb/vhdl/tb_reorder_col.vhd