Improve file headers

src/algorithms/telemetry_decoder/libs/libswiftcnav/bits.c

@@ -1,13 +1,32 @@
-/*
+/*!
+ * \file bits.c
+ * \author Fergus Noble <fergus@swift-nav.com>
+ *
+ * -------------------------------------------------------------------------
+ * This file was originally borrowed from libswiftnav
+ * <https://github.com/swift-nav/libswiftnav>,
+ * a portable C library implementing GNSS related functions and algorithms,
+ * and then modified by J. Arribas and C. Fernandez
+ *
  * Copyright (C) 2013, 2016 Swift Navigation Inc.
  * Contact: Fergus Noble <fergus@swift-nav.com>
  *
- * This source is subject to the license found in the file 'LICENSE' which must
+ * GNSS-SDR is a software defined Global Navigation
- * be be distributed together with this source. All other rights reserved.
+ *          Satellite Systems receiver
  *
- * THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
+ * This file is part of GNSS-SDR.
- * EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED
+ *
- * WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE.
+ * This file is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation, version 3.
+ *
+ * This program 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
+ * Lesser General Lesser Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
  */
 
 #include "bits.h"

src/algorithms/telemetry_decoder/libs/libswiftcnav/bits.h

@@ -1,13 +1,32 @@
-/*
+/*!
+ * \file bits.h
+ * \author Fergus Noble <fergus@swift-nav.com>
+ *
+ * -------------------------------------------------------------------------
+ * This file was originally borrowed from libswiftnav
+ * <https://github.com/swift-nav/libswiftnav>,
+ * a portable C library implementing GNSS related functions and algorithms,
+ * and then modified by J. Arribas and C. Fernandez
+ *
  * Copyright (C) 2013, 2016 Swift Navigation Inc.
  * Contact: Fergus Noble <fergus@swift-nav.com>
  *
- * This source is subject to the license found in the file 'LICENSE' which must
+ * GNSS-SDR is a software defined Global Navigation
- * be be distributed together with this source. All other rights reserved.
+ *          Satellite Systems receiver
  *
- * THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
+ * This file is part of GNSS-SDR.
- * EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED
+ *
- * WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE.
+ * This file is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation, version 3.
+ *
+ * This program 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
+ * Lesser General Lesser Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
  */
 
 #ifndef LIBSWIFTNAV_BITS_H

src/algorithms/telemetry_decoder/libs/libswiftcnav/cnav_msg.c

@@ -1,15 +1,36 @@
-/*
+/*!
+ * \file cnav_msg.c
+ * \author Valeri Atamaniouk <valeri@swift-nav.com>
+ *
+ * -------------------------------------------------------------------------
+ * This file was originally borrowed from libswiftnav
+ * <https://github.com/swift-nav/libswiftnav>,
+ * a portable C library implementing GNSS related functions and algorithms,
+ * and then modified by J. Arribas and C. Fernandez
+ *
  * Copyright (C) 2016 Swift Navigation Inc.
  * Contact: Valeri Atamaniouk <valeri@swift-nav.com>
  *
- * This source is subject to the license found in the file 'LICENSE' which must
+ * GNSS-SDR is a software defined Global Navigation
- * be be distributed together with this source. All other rights reserved.
+ *          Satellite Systems receiver
  *
- * THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
+ * This file is part of GNSS-SDR.
- * EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED
+ *
- * WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE.
+ * This file is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation, version 3.
+ *
+ * This program 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
+ * Lesser General Lesser Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
  */
 
+
+
 #include "edc.h"
 #include "bits.h"
 #include "cnav_msg.h"

src/algorithms/telemetry_decoder/libs/libswiftcnav/cnav_msg.h

@@ -1,15 +1,35 @@
-/*
+/*!
+ * \file cnav_msg.h
+ * \author Valeri Atamaniouk <valeri@swift-nav.com>
+ *
+ * -------------------------------------------------------------------------
+ * This file was originally borrowed from libswiftnav
+ * <https://github.com/swift-nav/libswiftnav>,
+ * a portable C library implementing GNSS related functions and algorithms,
+ * and then modified by J. Arribas and C. Fernandez
+ *
  * Copyright (C) 2016 Swift Navigation Inc.
  * Contact: Valeri Atamaniouk <valeri@swift-nav.com>
  *
- * This source is subject to the license found in the file 'LICENSE' which must
+ * GNSS-SDR is a software defined Global Navigation
- * be be distributed together with this source. All other rights reserved.
+ *          Satellite Systems receiver
  *
- * THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
+ * This file is part of GNSS-SDR.
- * EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED
+ *
- * WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE.
+ * This file is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation, version 3.
+ *
+ * This program 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
+ * Lesser General Lesser Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
  */
 
+
 #ifndef LIBSWIFTNAV_CNAV_MSG_H
 #define LIBSWIFTNAV_CNAV_MSG_H
 

src/algorithms/telemetry_decoder/libs/libswiftcnav/edc.c

@@ -1,13 +1,32 @@
-/*
+/*!
+ * \file edc.c
+ * \author Fergus Noble <fergus@swift-nav.com>
+ *
+ * -------------------------------------------------------------------------
+ * This file was originally borrowed from libswiftnav
+ * <https://github.com/swift-nav/libswiftnav>,
+ * a portable C library implementing GNSS related functions and algorithms,
+ * and then modified by J. Arribas and C. Fernandez
+ *
  * Copyright (C) 2010 Swift Navigation Inc.
  * Contact: Fergus Noble <fergus@swift-nav.com>
  *
- * This source is subject to the license found in the file 'LICENSE' which must
+ * GNSS-SDR is a software defined Global Navigation
- * be be distributed together with this source. All other rights reserved.
+ *          Satellite Systems receiver
  *
- * THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
+ * This file is part of GNSS-SDR.
- * EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED
+ *
- * WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE.
+ * This file is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation, version 3.
+ *
+ * This program 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
+ * Lesser General Lesser Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
  */
 
 #include "edc.h"

src/algorithms/telemetry_decoder/libs/libswiftcnav/edc.h

@@ -1,15 +1,35 @@
-/*
+/*!
+ * \file edc.h
+ * \author Fergus Noble <fergus@swift-nav.com>
+ *
+ * -------------------------------------------------------------------------
+ * This file was originally borrowed from libswiftnav
+ * <https://github.com/swift-nav/libswiftnav>,
+ * a portable C library implementing GNSS related functions and algorithms,
+ * and then modified by J. Arribas and C. Fernandez
+ *
  * Copyright (C) 2010 Swift Navigation Inc.
  * Contact: Fergus Noble <fergus@swift-nav.com>
  *
- * This source is subject to the license found in the file 'LICENSE' which must
+ * GNSS-SDR is a software defined Global Navigation
- * be be distributed together with this source. All other rights reserved.
+ *          Satellite Systems receiver
  *
- * THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
+ * This file is part of GNSS-SDR.
- * EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED
+ *
- * WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE.
+ * This file is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation, version 3.
+ *
+ * This program 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
+ * Lesser General Lesser Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
  */
 
+
 #ifndef LIBSWIFTNAV_EDC_H
 #define LIBSWIFTNAV_EDC_H
 

src/algorithms/telemetry_decoder/libs/libswiftcnav/fec.h

@@ -1,10 +1,36 @@
-/* User include file for libfec
+/*!
- * Copyright 2004, Phil Karn, KA9Q
+ * \file fec.h
- * May be used under the terms of the GNU Lesser General Public License (LGPL)
+ * \author Phil Karn, KA9Q
+ *
+ * -------------------------------------------------------------------------
+ * This file was originally borrowed from libswiftnav
+ * <https://github.com/swift-nav/libswiftnav>,
+ * a portable C library implementing GNSS related functions and algorithms,
+ * and then modified by J. Arribas and C. Fernandez
+ *
+ * Copyright (C) 2004, Phil Karn, KA9Q
+ *
+ * GNSS-SDR is a software defined Global Navigation
+ *          Satellite Systems receiver
+ *
+ * This file is part of GNSS-SDR.
+ *
+ * This file is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation, version 3.
+ *
+ * This program 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
+ * Lesser General Lesser Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
  */
 
-#ifndef _FEC_H_
+
-#define _FEC_H_
+#ifndef LIBSWIFTNAV_FEC_H_
+#define LIBSWIFTNAV_FEC_H_
 
 /* r=1/2 k=7 convolutional encoder polynomials
  * The NASA-DSN convention is to use V27POLYA inverted, then V27POLYB

src/algorithms/telemetry_decoder/libs/libswiftcnav/swift_common.h

@@ -1,16 +1,37 @@
-/*
+/*!
+ * \file swift_common.h
+ * \author Henry Hallam <henry@swift-nav.com>
+ *         Fergus Noble <fergus@swift-nav.com>
+ *
+ * -------------------------------------------------------------------------
+ * This file was originally borrowed from libswiftnav
+ * <https://github.com/swift-nav/libswiftnav>,
+ * a portable C library implementing GNSS related functions and algorithms,
+ * and then modified by J. Arribas and C. Fernandez
+ *
  * Copyright (C) 2012 Swift Navigation Inc.
  * Contact: Henry Hallam <henry@swift-nav.com>
  *          Fergus Noble <fergus@swift-nav.com>
  *
- * This source is subject to the license found in the file 'LICENSE' which must
+ * GNSS-SDR is a software defined Global Navigation
- * be be distributed together with this source. All other rights reserved.
+ *          Satellite Systems receiver
  *
- * THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
+ * This file is part of GNSS-SDR.
- * EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED
+ *
- * WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE.
+ * This file is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation, version 3.
+ *
+ * This program 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
+ * Lesser General Lesser Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
  */
 
+
 #ifndef LIBSWIFTNAV_COMMON_H
 #define LIBSWIFTNAV_COMMON_H
 

src/algorithms/telemetry_decoder/libs/libswiftcnav/viterbi27.c

@@ -1,10 +1,36 @@
-/* K=7 r=1/2 Viterbi decoder in portable C
+/*!
- * Copyright Feb 2004, Phil Karn, KA9Q
+ * \file viterbi27.c
- * May be used under the terms of the GNU Lesser General Public License (LGPL)
+ * \author Phil Karn, KA9Q
+ * \brief K=7 r=1/2 Viterbi decoder in portable C
+ *
+ * -------------------------------------------------------------------------
+ * This file was originally borrowed from libswiftnav
+ * <https://github.com/swift-nav/libswiftnav>,
+ * a portable C library implementing GNSS related functions and algorithms,
+ * and then modified by J. Arribas and C. Fernandez
+ *
+ * Copyright (C) 2004, Phil Karn, KA9Q
+ *
+ * GNSS-SDR is a software defined Global Navigation
+ *          Satellite Systems receiver
+ *
+ * This file is part of GNSS-SDR.
+ *
+ * This file is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation, version 3.
+ *
+ * This program 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
+ * Lesser General Lesser Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
  */
 
-#include <stdlib.h>
 
+#include <stdlib.h>
 #include "fec.h"
 
 static inline int parity(int x)