Updated headers for doxygen, matching those in x393 project

ahci/ahci_ctrl_stat.v

-/*******************************************************************************
- * Module: ahci_ctrl_stat
- * Date:2016-01-12  
- * Author: Andrey Filippov     
- * Description: Copy of significant register fields, updating them in
+/*!
+ * <b>Module:</b>ahci_ctrl_stat
+ * @file ahci_ctrl_stat.v
+ * @date 2016-01-12  
+ * @author Andrey Filippov     
+ *
+ * @brief Copy of significant register fields, updating them in
  * axi_ahci_regs registers (software accessible)
  *
- * Copyright (c) 2016 Elphel, Inc .
+ * @copyright Copyright (c) 2016 Elphel, Inc .
+ *
+ * <b>License:</b>
+ *
  * ahci_ctrl_stat.v is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
@@ -18,7 +23,7 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program.  If not, see <http://www.gnu.org/licenses/> .
- *******************************************************************************/
+ */
 `timescale 1ns/1ps
 
 module  ahci_ctrl_stat #(

ahci/ahci_dma.v

-/*******************************************************************************
- * Module: ahci_dma
- * Date:2016-01-01  
- * Author: Andrey Filippov     
- * Description: DMA R/W over 64-AXI channel for AHCI implementation
+/*!
+ * <b>Module:</b>ahci_dma
+ * @file ahci_dma.v
+ * @date 2016-01-01  
+ * @author Andrey Filippov     
+ *
+ * @brief DMA R/W over 64-AXI channel for AHCI implementation
+ *
+ * @copyright Copyright (c) 2016 Elphel, Inc .
+ *
+ * <b>License:</b>
  *
- * Copyright (c) 2016 Elphel, Inc .
  * ahci_dma.v is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
@@ -30,7 +35,7 @@
  * the combined code. This permission applies to you if the distributed code
  * contains all the components and scripts required to completely simulate it
  * with at least one of the Free Software programs.
- *******************************************************************************/
+ */
 `timescale 1ns/1ps
 
 module  ahci_dma (

ahci/ahci_dma_rd_fifo.v

-/*******************************************************************************
- * Module: ahci_dma_rd_fifo
- * Date:2016-01-01  
- * Author: Andrey Filippov
- * Description: cross clocks,  word-realign, 64->32
+/*!
+ * <b>Module:</b>ahci_dma_rd_fifo
+ * @file ahci_dma_rd_fifo.v
+ * @date 2016-01-01  
+ * @author Andrey Filippov
+ *
+ * @brief cross clocks,  word-realign, 64->32
  * Convertion from x64 QWORD-aligned AXI data @hclk to
  * 32-bit word-aligned data at mclk
  *
- * Copyright (c) 2016 Elphel, Inc .
+ * @copyright Copyright (c) 2016 Elphel, Inc .
+ *
+ * <b>License:</b>
+ *
  * ahci_dma_rd_fifo.v is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
@@ -32,7 +37,7 @@
  * the combined code. This permission applies to you if the distributed code
  * contains all the components and scripts required to completely simulate it
  * with at least one of the Free Software programs.
- *******************************************************************************/
+ */
 `timescale 1ns/1ps
 
 module  ahci_dma_rd_fifo#(

ahci/ahci_dma_rd_stuff.v

-/*******************************************************************************
- * Module: ahci_dma_rd_stuff
- * Date:2016-01-01  
- * Author: Andrey Filippov     
- * Description: Stuff DWORD data with missing words into continuous 32-bit data
+/*!
+ * <b>Module:</b>ahci_dma_rd_stuff
+ * @file ahci_dma_rd_stuff.v
+ * @date 2016-01-01  
+ * @author Andrey Filippov     
+ *
+ * @brief Stuff DWORD data with missing words into continuous 32-bit data
+ *
+ * @copyright Copyright (c) 2016 Elphel, Inc .
+ *
+ * <b>License:</b>
  *
- * Copyright (c) 2016 Elphel, Inc .
  * ahci_dma_rd_stuff.v is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
@@ -30,7 +35,7 @@
  * the combined code. This permission applies to you if the distributed code
  * contains all the components and scripts required to completely simulate it
  * with at least one of the Free Software programs.
- *******************************************************************************/
+ */
 `timescale 1ns/1ps
 
 module  ahci_dma_rd_stuff(

ahci/ahci_dma_wr_fifo.v

-/*******************************************************************************
- * Module: ahci_dma_wr_fifo
- * Date:2016-01-02  
- * Author: Andrey Filippov
- * Description: cross clocks,  word-realign, 32 -> 64 with byte write mask
+/*!
+ * <b>Module:</b>ahci_dma_wr_fifo
+ * @file ahci_dma_wr_fifo.v
+ * @date 2016-01-02  
+ * @author Andrey Filippov
+ *
+ * @brief cross clocks,  word-realign, 32 -> 64 with byte write mask
  * Convertion from x32 DWORD data received from FIS-es @ mclk to QWORD-aligned
  * AXI data @hclk
  *
- * Copyright (c) 2016 Elphel, Inc .
+ * @copyright Copyright (c) 2016 Elphel, Inc .
+ *
+ * <b>License:</b>
+ *
  * ahci_dma_wr_fifo.v is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
@@ -32,7 +37,7 @@
  * the combined code. This permission applies to you if the distributed code
  * contains all the components and scripts required to completely simulate it
  * with at least one of the Free Software programs.
- *******************************************************************************/
+ */
 `timescale 1ns/1ps
 
 module  ahci_dma_wr_fifo#(

ahci/ahci_fis_receive.v

-/*******************************************************************************
- * Module: ahci_fis_receive
- * Date:2016-01-06  
- * Author: Andrey Filippov      
- * Description: Receives incoming FIS-es, forwards DMA ones to DMA engine
+/*!
+ * <b>Module:</b>ahci_fis_receive
+ * @file ahci_fis_receive.v
+ * @date 2016-01-06  
+ * @author Andrey Filippov      
+ *
+ * @brief Receives incoming FIS-es, forwards DMA ones to DMA engine
  * Stores received FIS-es if requested
  *
  * 'fis_first_vld' is asserted when the FIFO output contains first DWORD
@@ -13,7 +15,10 @@
  * one of the 3 states (fis_ok, fis_err and fis_ferr) are raised 
  * This module also receives/updates device signature and PxTFD ERR and STS.
  *
- * Copyright (c) 2016 Elphel, Inc .
+ * @copyright Copyright (c) 2016 Elphel, Inc .
+ *
+ * <b>License:</b>
+ *
  * ahci_fis_receive.v is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
@@ -26,7 +31,7 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program.  If not, see <http://www.gnu.org/licenses/> .
- *******************************************************************************/
+ */
 `timescale 1ns/1ps
 
 module  ahci_fis_receive#(

ahci/ahci_fis_transmit.v

-/*******************************************************************************
- * Module: ahci_fis_transmit
- * Date:2016-01-07  
- * Author: Andrey Filippov     
- * Description: Fetches commands, command tables, creates/sends FIS
+/*!
+ * <b>Module:</b>ahci_fis_transmit
+ * @file ahci_fis_transmit.v
+ * @date 2016-01-07  
+ * @author Andrey Filippov     
+ *
+ * @brief Fetches commands, command tables, creates/sends FIS
+ *
+ * @copyright Copyright (c) 2016 Elphel, Inc .
+ *
+ * <b>License:</b>
  *
- * Copyright (c) 2016 Elphel, Inc .
  * ahci_fis_transmit.v is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
@@ -17,7 +22,7 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program.  If not, see <http://www.gnu.org/licenses/> .
- *******************************************************************************/
+ */
 `timescale 1ns/1ps
 
 module  ahci_fis_transmit #(

ahci/ahci_fsm.v

-/*******************************************************************************
- * Module: ahci_fsm
- * Date:2016-01-10  
- * Author: Andrey Filippov     
- * Description: AHCI host+port0 state machine
+/*!
+ * <b>Module:</b>ahci_fsm
+ * @file ahci_fsm.v
+ * @date 2016-01-10  
+ * @author Andrey Filippov     
+ *
+ * @brief AHCI host+port0 state machine
+ *
+ * @copyright Copyright (c) 2016 Elphel, Inc .
+ *
+ * <b>License:</b>
  *
- * Copyright (c) 2016 Elphel, Inc .
  * ahci_fsm.v is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
@@ -17,7 +22,7 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program.  If not, see <http://www.gnu.org/licenses/> .
- *******************************************************************************/
+ */
 `timescale 1ns/1ps
 
 module  ahci_fsm 
@@ -318,7 +323,6 @@ module  ahci_fsm
     wire                           clear_pisn32; // additional clear when in P:NotRunning state
     
     assign fsm_next = (fsm_preload || (fsm_actions && !update_busy && !fsm_act_busy) || fsm_transitions[0]) && !async_pend_r[0]; // quiet if received cominit is pending
-
     assign update_all = fsm_jump[0];
 
     assign ssts_ipm_dnp =      phy_ready_chng_r && (phy_ready_prev == 0);  // device not present or communication not established

ahci/ahci_sata_layers.v

-/*******************************************************************************
- * Module: ahci_sata_layers
- * Date:2016-01-19  
- * Author: Andrey Filippov     
- * Description: Link and PHY SATA layers
+/*!
+ * <b>Module:</b>ahci_sata_layers
+ * @file ahci_sata_layers.v
+ * @date 2016-01-19  
+ * @author Andrey Filippov     
+ *
+ * @brief Link and PHY SATA layers
+ *
+ * @copyright Copyright (c) 2016 Elphel, Inc .
+ *
+ * <b>License:</b>
  *
- * Copyright (c) 2016 Elphel, Inc .
  * ahci_sata_layers.v is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
@@ -17,7 +22,7 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program.  If not, see <http://www.gnu.org/licenses/> .
- *******************************************************************************/
+ */
 `timescale 1ns/1ps
 
 module  ahci_sata_layers #(

ahci/ahci_top.v

-/*******************************************************************************
- * Module: ahci_top
- * Date:2016-01-09  
- * Author: Andrey Filippov     
- * Description: Top module of the AHCI implementation
+/*!
+ * <b>Module:</b>ahci_top
+ * @file ahci_top.v
+ * @date 2016-01-09  
+ * @author Andrey Filippov     
+ *
+ * @brief Top module of the AHCI implementation
  * 
- * Copyright (c) 2016 Elphel, Inc .
+ * @copyright Copyright (c) 2016 Elphel, Inc .
+ *
+ * <b>License:</b>
+ *
  * ahci_top.v is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
@@ -17,7 +22,7 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program.  If not, see <http://www.gnu.org/licenses/> .
- *******************************************************************************/
+ */
 `timescale 1ns/1ps
 
 module  ahci_top#(

ahci/axi_ahci_regs.v

-/*******************************************************************************
- * Module: axi_ahci_regs
- * Date:2015-12-29  
- * Author: Andrey Filippov
- * Description: Registers for single-port AHCI over AXI implementation
+/*!
+ * <b>Module:</b>axi_ahci_regs
+ * @file axi_ahci_regs.v
+ * @date 2015-12-29  
+ * @author Andrey Filippov
+ *
+ * @brief Registers for single-port AHCI over AXI implementation
  * Combination of PCI Headers, PCI power management, and HBA memory
  * 128 DWORD registers 
  * Registers, with bits being RO, RW, RWC, RW1
  *
- * Copyright (c) 2015 Elphel, Inc .
+ * @copyright Copyright (c) 2015 Elphel, Inc .
+ *
+ * <b>License:</b>
+ *
  * axi_ahci_regs.v is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
@@ -33,7 +38,7 @@
  * the combined code. This permission applies to you if the distributed code
  * contains all the components and scripts required to completely simulate it
  * with at least one of the Free Software programs.
- *******************************************************************************/
+ */
 `timescale 1ns/1ps
 
 

ahci/axi_hp_abort.v

-/*******************************************************************************
- * Module: axi_hp_abort
- * Date:2016-02-07  
- * Author: Andrey Filippov     
- * Description: Trying to gracefully reset AXI HP after aborted transmission
+/*!
+ * <b>Module:</b>axi_hp_abort
+ * @file axi_hp_abort.v
+ * @date 2016-02-07  
+ * @author Andrey Filippov     
+ *
+ * @brief Trying to gracefully reset AXI HP after aborted transmission
  * For read channel - just keep afi_rready on until RD FIFO is empty (afi_rcount ==0)
  * For write - keep track aof all what was sent so far, assuming aw is always ahead of w
  * Reset only by global reset (system POR) - probably it is not possible to just
  * reset PL or relaod bitfile, 
  *
- * Copyright (c) 2016 Elphel, Inc .
+ * @copyright Copyright (c) 2016 Elphel, Inc .
+ *
+ * <b>License:</b>
+ *
  * axi_hp_abort.v is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
@@ -21,7 +26,7 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program.  If not, see <http://www.gnu.org/licenses/> .
- *******************************************************************************/
+ */
 `timescale 1ns/1ps
 
 module  axi_hp_abort(

ahci/freq_meter.v

-/*******************************************************************************
- * Module: freq_meter
- * Date:2016-02-13  
- * Author: Andrey Filippov     
- * Description: Measure device clock frequency to set the local clock
+/*!
+ * <b>Module:</b>freq_meter
+ * @file freq_meter.v
+ * @date 2016-02-13  
+ * @author Andrey Filippov     
+ *
+ * @brief Measure device clock frequency to set the local clock
+ *
+ * @copyright Copyright (c) 2016 Elphel, Inc .
+ *
+ * <b>License:</b>
  *
- * Copyright (c) 2016 Elphel, Inc .
  * freq_meter.v is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
@@ -17,7 +22,7 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program.  If not, see <http://www.gnu.org/licenses/> .
- *******************************************************************************/
+ */
 `timescale 1ns/1ps
 
 module  freq_meter#(

ahci/sata_ahci_top.v

-/*******************************************************************************
- * Module: sata_ahci_top
- * Date: 2015-07-11  
- * Author: Alexey     
- * Description: sata for z7nq top-level module
+/*!
+ * <b>Module:</b>sata_ahci_top
+ * @file sata_ahci_top.v
+ * @date  2015-07-11  
+ * @author Alexey     
+ *
+ * @brief Top of the AHCI implementation of the host adapter
+ *
+ * @copyright Copyright (c) 2015 Elphel, Inc.
+ *
+ * <b>License:</b>
  *
- * Copyright (c) 2015 Elphel, Inc.
  * sata_ahci_top.v is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
@@ -30,7 +35,7 @@
  * the combined code. This permission applies to you if the distributed code
  * contains all the components and scripts required to completely simulate it
  * with at least one of the Free Software programs.
- *******************************************************************************/
+ */
 `timescale 1ns/1ps
 /*
  * Takes commands from axi iface as a slave, transfers data with another axi iface as a master

device/oob_dev.v

-/*******************************************************************************
- * Module: oob
- * Date: 2015-07-11  
- * Author: Alexey     
- * Description: sata oob unit implementation
+/*!
+ * <b>Module:</b>oob_dev
+ * @file oob_dev.v
+ * @date  2015-07-11  
+ * @author Alexey     
  *
- * Copyright (c) 2015 Elphel, Inc.
- * oob.v is free software; you can redistribute it and/or modify
+ * @brief sata oob unit implementation
+ *
+ * @copyright Copyright (c) 2015 Elphel, Inc.
+ *
+ * <b>License:</b>
+ *
+ * oob_dev.v is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
  * (at your option) any later version.
  *
- * oob.v file is distributed in the hope that it will be useful,
+ * oob_dev.v file is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
@@ -30,7 +35,7 @@
  * the combined code. This permission applies to you if the distributed code
  * contains all the components and scripts required to completely simulate it
  * with at least one of the Free Software programs.
- *******************************************************************************/
+ */
 /*
  * For now both device and host shall be set up to SATA2 speeds.
  * Need to think how to change speed grades on fly (either to broaden 

device/sata_phy_dev.v

-/*******************************************************************************
- * Module: sata_phy
- * Date: 2015-07-11  
- * Author: Alexey     
- * Description: phy-level, including oob, clock generation and GTXE2 
+/*!
+ * <b>Module:</b>sata_phy_dev
+ * @file sata_phy_dev.v
+ * @date  2015-07-11  
+ * @author Alexey     
  *
- * Copyright (c) 2015 Elphel, Inc.
- * sata_phy.v is free software; you can redistribute it and/or modify
+ * @brief phy-level, including oob, clock generation and GTXE2 
+ *
+ * @copyright Copyright (c) 2015 Elphel, Inc.
+ *
+ * <b>License:</b>
+ *
+ * sata_phy_dev.v is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
  * (at your option) any later version.
  *
- * sata_phy.v file is distributed in the hope that it will be useful,
+ * sata_phy_dev.v file is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
@@ -30,7 +35,7 @@
  * the combined code. This permission applies to you if the distributed code
  * contains all the components and scripts required to completely simulate it
  * with at least one of the Free Software programs.
- *******************************************************************************/
+ */
 //`include "oob_dev.v"
 module sata_phy_dev #(
     parameter DATA_BYTE_WIDTH = 4

generated/action_decoder.v

-/*******************************************************************************
- * Module: action_decoder
- * Date:2016-12-07  
- * Author: auto-generated file, see ahci_fsm_sequence.py
- * Description: Decode sequencer code to 1-hot actions
- *******************************************************************************/
+/*!
+ * <b>Module:</b>action_decoder
+ * @file   action_decoder.v 
+ * @date   2016-12-08  
+ * @author auto-generated file, see ahci_fsm_sequence.py
+ * @brief  Decode sequencer code to 1-hot actions
+ */
 
 `timescale 1ns/1ps
 

generated/condition_mux.v

-/*******************************************************************************
- * Module: condition_mux
- * Date:2016-12-07  
- * Author: auto-generated file, see ahci_fsm_sequence.py
- * Description: Select condition
- *******************************************************************************/
+/*!
+ * <b>Module:</b>condition_mux
+ * @file   condition_mux.v 
+ * @date   2016-12-08  
+ * @author auto-generated file, see ahci_fsm_sequence.py
+ * @brief  Select condition
+ */
 
 `timescale 1ns/1ps
 

host/crc.v

-/*******************************************************************************
- * Module: crc
- * Date: 2015-07-11  
- * Author: Alexey     
- * Description: crc calculations for the link layer
+/*!
+ * <b>Module:</b>crc
+ * @file crc.v
+ * @date  2015-07-11  
+ * @author Alexey     
+ *
+ * @brief crc calculations for the link layer
+ *
+ * @copyright Copyright (c) 2015 Elphel, Inc.
+ *
+ * <b>License:</b>
  *
- * Copyright (c) 2015 Elphel, Inc.
  * crc.v is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
@@ -30,7 +35,7 @@
  * the combined code. This permission applies to you if the distributed code
  * contains all the components and scripts required to completely simulate it
  * with at least one of the Free Software programs.
- *******************************************************************************/
+ */
 /* same as for a scrambler, @ doc p.561 */
 // TODO make it parallel, make another widths support
 module crc #(

host/drp_other_registers.v

-/*******************************************************************************
- * Module: drp_other_registers
- * Date:2016-03-13
- * Author: andrey     
- * Description: Additional registers controlled/read back over DRP
+/*!
+ * <b>Module:</b>drp_other_registers
+ * @file drp_other_registers.v
+ * @date 2016-03-13
+ * @author Andrey Filippov     
+ *
+ * @brief Additional registers controlled/read back over DRP
+ *
+ * @copyright Copyright (c) 2016 Elphel, Inc .
+ *
+ * <b>License:</b>
  *
- * Copyright (c) 2016 Elphel, Inc .
  * drp_other_registers.v is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
@@ -17,7 +22,7 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program.  If not, see <http://www.gnu.org/licenses/> .
- *******************************************************************************/
+ */
 `timescale 1ns/1ps
 
 module  drp_other_registers#(

host/elastic1632.v

-/*******************************************************************************
- * Module: elastic1632
- * Date:2016-02-03  
- * Author: andrey     
- * Description: Elastic buffer with 16-bit data input and 32-bit output
+/*!
+ * <b>Module:</b>elastic1632
+ * @file elastic1632.v
+ * @date 2016-02-03  
+ * @author Andrey Filippov     
+ *
+ * @brief Elastic buffer with 16-bit data input and 32-bit output
+ *
+ * @copyright Copyright (c) 2016 Elphel, Inc .
+ *
+ * <b>License:</b>
  *
- * Copyright (c) 2016 Elphel, Inc .
  * elastic1632.v is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
@@ -17,7 +22,7 @@
  *
  * You should have received a copy of the GNU General Public License
  * along with this program.  If not, see <http://www.gnu.org/licenses/> .
- *******************************************************************************/
+ */
 `timescale 1ns/1ps
 
 module  elastic1632#(

host/gtx_10x8dec.v

-/*******************************************************************************
- * Module: gtx_10x8dec
- * Date: 2015-07-11  
- * Author: Alexey     
- * Description: 8x10 encoder implementation
+/*!
+ * <b>Module:</b>gtx_10x8dec
+ * @file gtx_10x8dec.v
+ * @date  2015-07-11  
+ * @author Alexey     
+ *
+ * @brief 8x10 encoder implementation
+ *
+ * @copyright Copyright (c) 2015 Elphel, Inc.
+ *
+ * <b>License:</b>
  *
- * Copyright (c) 2015 Elphel, Inc.
  * gtx_10x8dec.v is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
@@ -30,7 +35,7 @@
  * the combined code. This permission applies to you if the distributed code
  * contains all the components and scripts required to completely simulate it
  * with at least one of the Free Software programs.
- *******************************************************************************/
+ */
 module gtx_10x8dec(
     input   wire    rst,
     input   wire    clk,

host/gtx_8x10enc.v

-/*******************************************************************************
- * Module: gtx_8x10enc
- * Date: 2015-07-11  
- * Author: Alexey     
- * Description: 8x10 encoder implementation
+/*!
+ * <b>Module:</b>gtx_8x10enc
+ * @file gtx_8x10enc.v
+ * @date  2015-07-11  
+ * @author Alexey     
+ *
+ * @brief 8x10 encoder implementation
+ *
+ * @copyright Copyright (c) 2015 Elphel, Inc.
+ *
+ * <b>License:</b>
  *
- * Copyright (c) 2015 Elphel, Inc.
  * gtx_8x10enc.v is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
@@ -30,7 +35,7 @@
  * the combined code. This permission applies to you if the distributed code
  * contains all the components and scripts required to completely simulate it
  * with at least one of the Free Software programs.
- *******************************************************************************/
+ */
 module gtx_8x10enc(
     input   wire    rst,
     input   wire    clk,

host/gtx_comma_align.v

-/*******************************************************************************
- * Module: gtx_comma_align
- * Date: 2015-07-11  
- * Author: Alexey     
- * Description: comma aligner implementation
+/*!
+ * <b>Module:</b>gtx_comma_align
+ * @file gtx_comma_align.v
+ * @date  2015-07-11  
+ * @author Alexey     
+ *
+ * @brief comma aligner implementation
+ *
+ * @copyright Copyright (c) 2015 Elphel, Inc.
+ *
+ * <b>License:</b>
  *
- * Copyright (c) 2015 Elphel, Inc.
  * gtx_comma_align.v is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
@@ -30,7 +35,7 @@
  * the combined code. This permission applies to you if the distributed code
  * contains all the components and scripts required to completely simulate it
  * with at least one of the Free Software programs.
- *******************************************************************************/
+ */
 module gtx_comma_align(
     input   wire            rst,
     input   wire            clk,

host/gtx_elastic.v

-/*******************************************************************************
- * Module: gtx_elastic
- * Date: 2015-07-11  
- * Author: Alexey     
- * Description: elastic buffer implementation
+/*!
+ * <b>Module:</b>gtx_elastic
+ * @file gtx_elastic.v
+ * @date  2015-07-11  
+ * @author Alexey     
+ *
+ * @brief elastic buffer implementation
+ *
+ * @copyright Copyright (c) 2015 Elphel, Inc.
+ *
+ * <b>License:</b>
  *