Cleanup: make file headers more consistent

Also some descriptive text into doc-strings.

intern/ghost/intern/GHOST_DisplayManagerX11.cpp

@@ -15,7 +15,7 @@
  *
  * Copyright 2001-2002 NaN Holding BV. All rights reserved.
  *           1997-2001 Id Software, Inc. Video mode switching.
-                       Ported from Quake 2 by Alex Fraser <alex@phatcore.com>.
+ *                     Ported from Quake 2 by Alex Fraser <alex@phatcore.com>.
  */
 
 /** \file

intern/ghost/intern/GHOST_SystemX11.cpp

@@ -15,7 +15,7 @@
  *
  * Copyright 2001-2002 NaN Holding BV. All rights reserved.
  *           2009 Nokia Corporation and/or its subsidiary(-ies).
-                  Part of this code has been taken from Qt, under LGPL license.
+ *                Part of this code has been taken from Qt, under LGPL license.
  */
 
 /** \file

intern/sky/source/sky_model.cpp

@@ -22,7 +22,7 @@
  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  *
- * Copyright (c) 2012 - 2013, Lukas Hosek and Alexander Wilkie
+ * Copyright (c) 2012-2013, Lukas Hosek and Alexander Wilkie
  * All rights reserved.
  */
 

intern/sky/source/sky_model_data.h

@@ -22,7 +22,7 @@
  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  *
- * Copyright (c) 2012 - 2013, Lukas Hosek and Alexander Wilkie
+ * Copyright (c) 2012-2013, Lukas Hosek and Alexander Wilkie
  * All rights reserved.
  */
 

release/scripts/startup/bl_operators/vertexpaint_dirt.py

@@ -1,7 +1,5 @@
 # ***** BEGIN GPL LICENSE BLOCK *****
 #
-# Script copyright (C) Campbell J Barton
-#
 # This program 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 2
@@ -17,7 +15,8 @@
 # Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 #
 # ***** END GPL LICENSE BLOCK *****
-# --------------------------------------------------------------------------
+#
+# Copyright Campbell Barton
 
 # <pep8 compliant>
 

source/blender/blenkernel/BKE_mesh_fair.h

@@ -12,15 +12,14 @@
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
- *
- * Mesh Fairing algorithm designed by Brett Fedack, used in the addon "Mesh Fairing":
- * https://github.com/fedackb/mesh-fairing.
  */
 
 #pragma once
 
 /** \file
  * \ingroup bke
+ * Mesh Fairing algorithm designed by Brett Fedack, used in the addon "Mesh Fairing":
+ * https://github.com/fedackb/mesh-fairing.
  */
 
 #include "BLI_utildefines.h"

source/blender/blenkernel/intern/mesh_fair.cc

@@ -12,13 +12,12 @@
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
- *
- * Mesh Fairing algorithm designed by Brett Fedack, used in the addon "Mesh Fairing":
- * https://github.com/fedackb/mesh-fairing.
  */
 
 /** \file
  * \ingroup bke
+ * Mesh Fairing algorithm designed by Brett Fedack, used in the addon "Mesh Fairing":
+ * https://github.com/fedackb/mesh-fairing.
  */
 
 #include "BLI_map.hh"

source/blender/blenkernel/intern/object_update.c

@@ -13,7 +13,7 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  *
- * The Original Code is Copyright (C) 20014 by Blender Foundation.
+ * The Original Code is Copyright (C) 2014 by Blender Foundation.
  * All rights reserved.
  */
 

source/blender/blenlib/intern/scanfill.c

@@ -15,7 +15,6 @@
  *
  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
  * All rights reserved.
- * (uit traces) maart 95
  */
 
 /** \file

source/blender/blenlib/intern/winstuff_dir.c

@@ -12,7 +12,6 @@
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
- * Windows-posix compatibility layer for opendir/readdir/closedir
  */
 
 /** \file

source/blender/blenloader/intern/readblenentry.c

@@ -15,11 +15,11 @@
  *
  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
  * All rights reserved.
- * .blend file reading entry point
  */
 
 /** \file
  * \ingroup blenloader
+ * `.blend` file reading entry point.
  */
 
 #include <stddef.h>

source/blender/blenloader/intern/undofile.c

@@ -15,7 +15,6 @@
  *
  * The Original Code is Copyright (C) 2004 Blender Foundation
  * All rights reserved.
- * .blend file reading entry point
  */
 
 /** \file

source/blender/depsgraph/intern/eval/deg_eval_copy_on_write.h

@@ -13,7 +13,7 @@
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  *
- * The Original Code is Copyright (C) 20137Blender Foundation.
+ * The Original Code is Copyright (C) 2017 Blender Foundation.
  * All rights reserved.
  */
 

source/blender/editors/armature/meshlaplacian.c

@@ -12,11 +12,11 @@
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
- * meshlaplacian.c: Algorithms using the mesh laplacian.
  */
 
 /** \file
  * \ingroup edarmature
+ * Algorithms using the mesh laplacian.
  */
 
 #include "MEM_guardedalloc.h"

source/blender/editors/armature/meshlaplacian.h

@@ -12,12 +12,11 @@
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
- *
- * BIF_meshlaplacian.h: Algorithms using the mesh laplacian.
  */
 
 /** \file
  * \ingroup edarmature
+ * BIF_meshlaplacian.h: Algorithms using the mesh laplacian.
  */
 
 #pragma once

source/blender/geometry/CMakeLists.txt

@@ -14,7 +14,7 @@
 # along with this program; if not, write to the Free Software Foundation,
 # Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 #
-# The Original Code is Copyright (C) 2006, Blender Foundation
+# The Original Code is Copyright (C) 2006 Blender Foundation
 # All rights reserved.
 
 set(INC

source/blender/makesdna/intern/dna_defaults.c

@@ -12,8 +12,6 @@
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
- *
- * DNA default value access.
  */
 
 /** \file

source/blender/makesrna/intern/rna_particle.c

@@ -12,8 +12,8 @@
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
- * Adaptive time step
- * Copyright 2011 AutoCRC
+ *
+ * Copyright 2011 AutoCRC (adaptive time step)
  */
 
 /** \file

source/blender/python/intern/bpy_interface.c

@@ -12,8 +12,6 @@
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
- *
- * Chris Keith, Chris Want, Ken Hughes, Campbell Barton
  */
 
 /** \file

source/blender/windowmanager/intern/wm_window.c

@@ -14,8 +14,7 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  *
  * The Original Code is Copyright (C) 2007 Blender Foundation but based
- * on ghostwinlay.c (C) 2001-2002 by NaN Holding BV
- * All rights reserved.
+ * on ghostwinlay.c (C) 2001-2002 by NaN Holding BV. All rights reserved.
  */
 
 /** \file

tests/python/collada/animation/test_animation_simple.py

@@ -16,10 +16,12 @@
 #  Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 #
 # ##### END GPL LICENSE BLOCK #####
-#
-# Call as follows:
-# python collada_mesh_simple.py --blender PATH_TO_BLENDER_EXE --testdir PATH_TO_SVN/lib/tests/collada/mesh
-#
+
+"""
+Call as follows:
+python collada_mesh_simple.py --blender PATH_TO_BLENDER_EXE --testdir PATH_TO_SVN/lib/tests/collada/mesh
+"""
+
 import sys
 import bpy
 import argparse

tests/python/collada/mesh/test_mesh_simple.py

@@ -16,10 +16,12 @@
 #  Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 #
 # ##### END GPL LICENSE BLOCK #####
-#
-# Call as follows:
-# python collada_mesh_simple.py --blender PATH_TO_BLENDER_EXE --testdir PATH_TO_SVN/lib/tests/collada/mesh
-#
+
+"""
+Call as follows:
+python collada_mesh_simple.py --blender PATH_TO_BLENDER_EXE --testdir PATH_TO_SVN/lib/tests/collada/mesh
+"""
+
 import sys
 import bpy
 import argparse

tests/python/modules/global_report.py

@@ -1,5 +1,5 @@
 # Apache License, Version 2.0
-#
+
 # Generate a HTML page that links to all test reports.
 
 import glob

tests/python/modules/render_report.py

@@ -1,7 +1,9 @@
 # Apache License, Version 2.0
-#
-# Compare renders or screenshots against reference versions and generate
-# a HTML report showing the differences, for regression testing.
+
+"""
+Compare renders or screenshots against reference versions and generate
+a HTML report showing the differences, for regression testing.
+"""
 
 import glob
 import os