Cleanup: move file descriptions into doxygen file section

Continuation of 19100aa57d847699d17527b76c2fab1f4ab88885.

intern/ghost/intern/GHOST_DisplayManagerX11.cpp

@@ -13,11 +13,9 @@
  * 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) 2001-2002 by NaN Holding BV.
+ * Copyright 2001-2002 NaN Holding BV. All rights reserved.
- * All rights reserved.
+ *           1997-2001 Id Software, Inc. Video mode switching.
- * Video mode switching
+                       Ported from Quake 2 by Alex Fraser <alex@phatcore.com>.
- * Copyright (C) 1997-2001 Id Software, Inc.
- * Ported from Quake 2 by Alex Fraser <alex@phatcore.com>
  */
 
 /** \file

intern/ghost/intern/GHOST_SystemX11.cpp

@@ -13,10 +13,9 @@
  * 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) 2001-2002 by NaN Holding BV.
+ * Copyright 2001-2002 NaN Holding BV. All rights reserved.
- * 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.
- * Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
  */
 
 /** \file

intern/iksolver/extern/IK_solver.h

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

intern/iksolver/intern/IK_Math.h

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

intern/iksolver/intern/IK_QSegment.h

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

intern/iksolver/intern/IK_QTask.h

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

source/blender/blenkernel/intern/cdderivedmesh.c

@@ -15,11 +15,11 @@
  *
  * The Original Code is Copyright (C) 2006 Blender Foundation.
  * All rights reserved.
- * Implementation of CDDerivedMesh.
  */
 
 /** \file
  * \ingroup bke
+ * Implementation of #CDDerivedMesh.
  * BKE_cdderivedmesh.h contains the function prototypes for this file.
  */
 

source/blender/blenkernel/intern/writeavi.c

@@ -15,11 +15,11 @@
  *
  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
  * All rights reserved.
- * Functions for writing avi-format files.
- * Added interface for generic movie support (ton)
  */
 
 /** \file
+ * Functions for writing avi-format files.
+ * Added interface for generic movie support (ton)
  * \ingroup bke
  */
 

source/blender/blenlib/intern/BLI_dynstr.c

@@ -15,11 +15,11 @@
  *
  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
  * All rights reserved.
- * Dynamically sized string ADT
  */
 
 /** \file
  * \ingroup bli
+ * Dynamically sized string ADT.
  */
 
 #include <stdio.h>

source/blender/blenlib/intern/BLI_linklist.c

@@ -15,7 +15,6 @@
  *
  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
  * All rights reserved.
- * Support for linked lists.
  */
 
 /** \file

source/blender/blenlib/intern/path_util.c

@@ -15,11 +15,11 @@
  *
  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
  * All rights reserved.
- * various string, file, list operations.
  */
 
 /** \file
  * \ingroup bli
+ * Various string, file, list operations.
  */
 
 #include <ctype.h>

source/blender/blenlib/intern/winstuff.c

@@ -15,11 +15,11 @@
  *
  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
  * All rights reserved.
- * Windows-posix compatibility layer, windows-specific functions.
  */
 
 /** \file
  * \ingroup bli
+ * Windows-posix compatibility layer, windows-specific functions.
  */
 
 #ifdef WIN32

source/blender/blenloader/BLO_undofile.h

@@ -15,13 +15,13 @@
  *
  * The Original Code is Copyright (C) 2004 Blender Foundation.
  * All rights reserved.
- * external writefile function prototypes
  */
 
 #pragma once
 
 /** \file
  * \ingroup blenloader
+ * External writefile function prototypes.
  */
 
 #include "BLI_filereader.h"
@@ -91,6 +91,8 @@ void BLO_memfile_chunk_add(MemFileWriteData *mem_data, const char *buf, size_t s
 /**
  * Not memfile itself.
  */
+/* **************** support for memory-write, for undo buffers *************** */
+
 extern void BLO_memfile_free(MemFile *memfile);
 /**
  * Result is that 'first' is being freed.

source/blender/editors/armature/armature_add.c

@@ -15,11 +15,11 @@
  *
  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
  * All rights reserved.
- * Operators and API's for creating bones
  */
 
 /** \file
  * \ingroup edarmature
+ * Operators and API's for creating bones.
  */
 
 #include "DNA_anim_types.h"

source/blender/editors/armature/armature_edit.c

@@ -15,11 +15,11 @@
  *
  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
  * All rights reserved.
- * Armature EditMode tools - transforms, chain based editing, and other settings
  */
 
 /** \file
  * \ingroup edarmature
+ * Armature EditMode tools - transforms, chain based editing, and other settings.
  */
 
 #include "DNA_armature_types.h"

source/blender/editors/armature/armature_naming.c

@@ -15,11 +15,11 @@
  *
  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
  * All rights reserved.
- * Operators and API's for renaming bones both in and out of Edit Mode
  */
 
 /** \file
  * \ingroup edarmature
+ * Operators and API's for renaming bones both in and out of Edit Mode.
  *
  * This file contains functions/API's for renaming bones and/or working with them.
  */

source/blender/editors/armature/armature_relations.c

@@ -15,11 +15,11 @@
  *
  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
  * All rights reserved.
- * Operators for relations between bones and for transferring bones between armature objects
  */
 
 /** \file
  * \ingroup edarmature
+ * Operators for relations between bones and for transferring bones between armature objects.
  */
 
 #include "MEM_guardedalloc.h"

source/blender/editors/armature/armature_select.c

@@ -15,11 +15,11 @@
  *
  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
  * All rights reserved.
- * API's and Operators for selecting armature bones in EditMode
  */
 
 /** \file
  * \ingroup edarmature
+ * API's and Operators for selecting armature bones in EditMode.
  */
 
 #include "MEM_guardedalloc.h"

source/blender/editors/armature/armature_skinning.c

@@ -15,12 +15,12 @@
  *
  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
  * All rights reserved.
- * API's for creating vertex groups from bones
- * - Interfaces with heat weighting in meshlaplacian
  */
 
 /** \file
  * \ingroup edarmature
+ * API's for creating vertex groups from bones
+ * - Interfaces with heat weighting in meshlaplacian.
  */
 
 #include "DNA_armature_types.h"

source/blender/editors/include/UI_view2d.h

@@ -15,12 +15,12 @@
  *
  * The Original Code is Copyright (C) 2008 Blender Foundation.
  * All rights reserved.
- * Generic 2d view with should allow drawing grids,
- * panning, zooming, scrolling, ..
  */
 
 /** \file
  * \ingroup editorui
+ * Generic 2D view with should allow drawing grids,
+ * panning, zooming, scrolling, .. etc.
  */
 
 #pragma once

source/blender/editors/screen/screendump.c

@@ -15,11 +15,11 @@
  *
  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
  * All rights reserved.
- * Making screendumps.
  */
 
 /** \file
  * \ingroup edscr
+ * Making screenshots of the entire window or sub-regions.
  */
 
 #include <errno.h>

source/blender/editors/sculpt_paint/paint_hide.c

@@ -15,11 +15,11 @@
  *
  * The Original Code is Copyright (C) 2010 by Nicholas Bishop
  * All rights reserved.
- * Implements the PBVH node hiding operator
  */
 
 /** \file
  * \ingroup edsculpt
+ * Implements the PBVH node hiding operator.
  */
 
 #include "MEM_guardedalloc.h"

source/blender/editors/sculpt_paint/sculpt.c

@@ -15,11 +15,11 @@
  *
  * The Original Code is Copyright (C) 2006 by Nicholas Bishop
  * All rights reserved.
- * Implements the Sculpt Mode tools
  */
 
 /** \file
  * \ingroup edsculpt
+ * Implements the Sculpt Mode tools.
  */
 
 #include "MEM_guardedalloc.h"

source/blender/editors/sculpt_paint/sculpt_brush_types.c

@@ -15,11 +15,11 @@
  *
  * The Original Code is Copyright (C) 2006 by Nicholas Bishop
  * All rights reserved.
- * Implements the Sculpt Mode tools
  */
 
 /** \file
  * \ingroup edsculpt
+ * Implements the Sculpt Mode tools.
  */
 
 #include "MEM_guardedalloc.h"

source/blender/editors/sculpt_paint/sculpt_ops.c

@@ -15,11 +15,11 @@
  *
  * The Original Code is Copyright (C) 2006 by Nicholas Bishop
  * All rights reserved.
- * Implements the Sculpt Mode tools
  */
 
 /** \file
  * \ingroup edsculpt
+ * Implements the Sculpt Mode tools.
  */
 
 #include "MEM_guardedalloc.h"

source/blender/editors/sculpt_paint/sculpt_undo.c

@@ -15,11 +15,11 @@
  *
  * The Original Code is Copyright (C) 2006 by Nicholas Bishop
  * All rights reserved.
- * Implements the Sculpt Mode tools
  */
 
 /** \file
  * \ingroup edsculpt
+ * Implements the Sculpt Mode tools.
  */
 
 #include <stddef.h>

source/blender/editors/sculpt_paint/sculpt_uv.c

@@ -15,11 +15,11 @@
  *
  * The Original Code is Copyright (C) Blender Foundation, 2002-2009
  * All rights reserved.
- * UV Sculpt tools
  */
 
 /** \file
  * \ingroup edsculpt
+ * UV Sculpt tools.
  */
 
 #include "MEM_guardedalloc.h"

source/blender/ikplugin/BIK_api.h

@@ -15,7 +15,6 @@
  *
  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
  * All rights reserved.
- * Original author: Benoit Bolsee
  */
 
 /** \file

source/blender/ikplugin/intern/ikplugin_api.c

@@ -15,7 +15,6 @@
  *
  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
  * All rights reserved.
- * Original author: Benoit Bolsee
  */
 
 /** \file

source/blender/ikplugin/intern/ikplugin_api.h

@@ -15,7 +15,6 @@
  *
  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
  * All rights reserved.
- * Original author: Benoit Bolsee
  */
 
 /** \file

source/blender/ikplugin/intern/iksolver_plugin.c

@@ -15,7 +15,6 @@
  *
  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
  * All rights reserved.
- * Original author: Benoit Bolsee
  */
 
 /** \file

source/blender/ikplugin/intern/iksolver_plugin.h

@@ -15,7 +15,6 @@
  *
  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
  * All rights reserved.
- * Original author: Benoit Bolsee
  */
 
 /** \file

source/blender/ikplugin/intern/itasc_plugin.cpp

@@ -15,7 +15,6 @@
  *
  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
  * All rights reserved.
- * Original author: Benoit Bolsee
  */
 
 /** \file

source/blender/ikplugin/intern/itasc_plugin.h

@@ -15,7 +15,6 @@
  *
  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
  * All rights reserved.
- * Original author: Benoit Bolsee
  */
 
 /** \file

source/blender/imbuf/intern/divers.c

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

source/blender/imbuf/intern/filter.c

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

source/blender/imbuf/intern/readimage.c

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

source/blender/imbuf/intern/rectop.c

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

source/blender/imbuf/intern/rotate.c

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

source/blender/imbuf/intern/scaling.c

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

source/blender/imbuf/intern/util.c

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

source/blender/imbuf/intern/util_gpu.c

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

source/blender/imbuf/intern/writeimage.c

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

source/blender/makesdna/DNA_constraint_types.h

@@ -15,11 +15,11 @@
  *
  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
  * All rights reserved.
- * Constraint DNA data
  */
 
 /** \file
  * \ingroup DNA
+ * Constraint DNA data.
  */
 
 #pragma once

source/blender/makesdna/intern/dna_genfile.c

@@ -15,11 +15,11 @@
  *
  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
  * All rights reserved.
- * DNA handling
  */
 
 /** \file
  * \ingroup DNA
+ * \brief DNA handling
  *
  * Lowest-level functions for decoding the parts of a saved .blend
  * file, including interpretation of its SDNA block and conversion of

source/blender/makesdna/intern/dna_rename_defs.h

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

source/blender/nodes/composite/nodes/node_composite_blur.cc

@@ -15,7 +15,6 @@
  *
  * The Original Code is Copyright (C) 2006 Blender Foundation.
  * All rights reserved.
- * Juho Vepsäläinen
  */
 
 /** \file

source/blender/nodes/composite/nodes/node_composite_bokehblur.cc

@@ -15,7 +15,6 @@
  *
  * The Original Code is Copyright (C) 2006 Blender Foundation.
  * All rights reserved.
- * Juho Vepsäläinen
  */
 
 /** \file

source/blender/nodes/composite/nodes/node_composite_common.cc

@@ -15,7 +15,6 @@
  *
  * The Original Code is Copyright (C) 2006 Blender Foundation.
  * All rights reserved.
- * Juho Vepsäläinen
  */
 
 /** \file

source/blender/nodes/composite/nodes/node_composite_switchview.cc

@@ -15,7 +15,6 @@
  *
  * The Original Code is Copyright (C) 2006 Blender Foundation.
  * All rights reserved.
- * Dalai Felinto
  */
 
 /** \file

source/blender/nodes/shader/nodes/node_shader_common.cc

@@ -15,7 +15,6 @@
  *
  * The Original Code is Copyright (C) 2006 Blender Foundation.
  * All rights reserved.
- * Juho Vepsäläinen
  */
 
 /** \file

source/blender/nodes/texture/nodes/node_texture_common.c

@@ -15,7 +15,6 @@
  *
  * The Original Code is Copyright (C) 2006 Blender Foundation.
  * All rights reserved.
- * Juho Vepsäläinen
  */
 
 /** \file