From f08bc4d09dc646d29dbc8a692bbee709a0a85a0b Mon Sep 17 00:00:00 2001
From: boldyrev <alexey.boldyrev@cern.ch>
Date: Mon, 10 Apr 2017 19:08:04 +0300
Subject: [PATCH] Replace non-Doxygen purpose command with brief command

Former-commit-id: 36ed40a456a786ad468b75b6d02fa277dd7d6b3c
---
 AtlasTest/PyAthenaTests/share/pyevtinfo_jobOptions.py           | 2 +-
 AtlasTest/PyAthenaTests/share/pyfilter_stream_jobOptions.py     | 2 +-
 AtlasTest/PyAthenaTests/share/pythin_basic_jobOptions.py        | 2 +-
 AtlasTest/PyAthenaTests/share/pythin_jobOptions.py              | 2 +-
 AtlasTest/PyAthenaTests/share/pythin_mctruth_jobOptions.py      | 2 +-
 .../share/pythin_multistream_checker_jobOptions.py              | 2 +-
 AtlasTest/PyAthenaTests/share/pythin_multistream_jobOptions.py  | 2 +-
 Control/AthenaCommon/python/AthenaCommonFlags.py                | 2 +-
 Control/AthenaCommon/python/GlobalFlags.py                      | 2 +-
 Control/AthenaCommon/python/PoolInputFileListBase.py            | 2 +-
 DataQuality/dqm_algorithms/dqm_algorithms/GrubbsOutlierTest.h   | 2 +-
 DataQuality/dqm_algorithms/src/Chi2Test_2D.cxx                  | 2 +-
 DataQuality/dqm_algorithms/src/GrubbsOutlierTest.cxx            | 2 +-
 .../EventIndex/EventIndexProducer/share/POOL2EI_joboptions.py   | 2 +-
 .../GeoModel/AtlasGeoModel/python/GeoModelInit.py               | 2 +-
 Generators/McAsciiEventSelector/python/ReadMcAscii.py           | 2 +-
 .../InDetPrepRawDataToxAOD/python/InDetDxAODJobProperties.py    | 2 +-
 .../InDetPrepRawDataToxAOD/python/SCTxAODJobProperties.py       | 2 +-
 .../InDetExample/InDetRecExample/python/InDetJobProperties.py   | 2 +-
 InnerDetector/InDetExample/InDetRecExample/python/InDetKeys.py  | 2 +-
 .../InDetExample/InDetTrigRecExample/python/InDetTrigFlags.py   | 2 +-
 .../InDetTrigRecExample/python/InDetTrigJobProperties.py        | 2 +-
 .../InDetTrigRecExample/python/InDetTrigSliceSettings.py        | 1 -
 .../MuonDQA/MuonDQAMonFlags/python/MuonDQAProperFlags.py        | 2 +-
 .../D3PDMaker/MuonD3PDMaker/python/MuonD3PDMakerFlags.py        | 2 +-
 .../D3PDMaker/TrackD3PDMaker/python/TrackD3PDMakerFlags.py      | 2 +-
 .../D3PDMaker/TrackD3PDMaker/python/TrackD3PDMakerPixelFlags.py | 2 +-
 .../D3PDMaker/TrackD3PDMaker/python/TrackD3PDMakerSCTFlags.py   | 2 +-
 .../TrackD3PDMaker/src/SCTTrackParticleToMuonAssociationTool.h  | 2 +-
 .../src/TrackParticleToPixelClusterAssociationTool.h            | 2 +-
 .../src/TrackParticleToSCTClusterAssociationTool.h              | 2 +-
 PhysicsAnalysis/PanTauAnalysis/python/PanTauDPDFlags.py         | 2 +-
 PhysicsAnalysis/PanTauAnalysis/python/PanTauFlags.py            | 2 +-
 .../PanTauAnalysis/python/PanTauSeedBuilderAlg_Flags.py         | 2 +-
 PhysicsAnalysis/PanTauAnalysis/python/PanTauValidationFlags.py  | 2 +-
 .../MuonCombinedRecExample/python/MuonCombinedKeys.py           | 2 +-
 Simulation/ISF/ISF_Config/python/ISF_jobProperties.py           | 2 +-
 .../python/ISF_NativeFastCaloSimJobProperties.py                | 2 +-
 .../python/ISF_FastCaloSimJobProperties.py                      | 2 +-
 .../ISF_FatrasServices/python/ISF_FatrasJobProperties.py        | 2 +-
 .../ISF_ParSimServices/python/ISF_ParSimJobProperties.py        | 2 +-
 .../ISF_ParSimServices/python/ISF_ParSimTuning.py               | 2 +-
 Tools/PyUtils/bin/checkPlugins.py                               | 2 +-
 Tools/PyUtils/bin/cmtClients.py                                 | 2 +-
 Tools/PyUtils/bin/filter-and-merge-d3pd.py                      | 2 +-
 Tools/PyUtils/bin/merge-poolfiles.py                            | 2 +-
 .../TrkDetDescrSvc/python/TrkDetDescrJobProperties.py           | 2 +-
 .../TrigAlgorithms/TrigMinBias/python/TrigMinBiasProperties.py  | 2 +-
 .../TrigT2MinBias/python/TrigT2MinBiasProperties.py             | 2 +-
 49 files changed, 48 insertions(+), 49 deletions(-)

diff --git a/AtlasTest/PyAthenaTests/share/pyevtinfo_jobOptions.py b/AtlasTest/PyAthenaTests/share/pyevtinfo_jobOptions.py
index cab229359b2..528426b2157 100644
--- a/AtlasTest/PyAthenaTests/share/pyevtinfo_jobOptions.py
+++ b/AtlasTest/PyAthenaTests/share/pyevtinfo_jobOptions.py
@@ -1,5 +1,5 @@
 ## @file PyAthenaTests/share/pyevtinfo_jobOptions.py
-## @purpose read a POOL file and dump/print out run and event numbers
+## @brief read a POOL file and dump/print out run and event numbers
 
 ###########################
 if not 'EVTMAX' in dir():
diff --git a/AtlasTest/PyAthenaTests/share/pyfilter_stream_jobOptions.py b/AtlasTest/PyAthenaTests/share/pyfilter_stream_jobOptions.py
index 0445f01ddce..f5cb2350912 100644
--- a/AtlasTest/PyAthenaTests/share/pyfilter_stream_jobOptions.py
+++ b/AtlasTest/PyAthenaTests/share/pyfilter_stream_jobOptions.py
@@ -1,5 +1,5 @@
 ## @file PyAthenaTests/share/pyfilter_stream_jobOptions.py
-## @purpose read a POOL file and dump/print out run and event numbers and filter
+## @brief read a POOL file and dump/print out run and event numbers and filter
 ##          out one event out of 2
 
 ###########################
diff --git a/AtlasTest/PyAthenaTests/share/pythin_basic_jobOptions.py b/AtlasTest/PyAthenaTests/share/pythin_basic_jobOptions.py
index 28417112688..a9445357823 100644
--- a/AtlasTest/PyAthenaTests/share/pythin_basic_jobOptions.py
+++ b/AtlasTest/PyAthenaTests/share/pythin_basic_jobOptions.py
@@ -1,5 +1,5 @@
 ## @file PyAthenaTests/share/pythin_basic_jobOptions.py
-## @purpose read a POOL file and thin out some elements
+## @brief read a POOL file and thin out some elements
 
 ###############################################
 if not 'EVTMAX' in dir():
diff --git a/AtlasTest/PyAthenaTests/share/pythin_jobOptions.py b/AtlasTest/PyAthenaTests/share/pythin_jobOptions.py
index 1bf111cbcc3..7aace903612 100644
--- a/AtlasTest/PyAthenaTests/share/pythin_jobOptions.py
+++ b/AtlasTest/PyAthenaTests/share/pythin_jobOptions.py
@@ -1,5 +1,5 @@
 ## @file PyAthenaTests/share/pythin_jobOptions.py
-## @purpose read an AOD POOL file and thin out some elements
+## @brief read an AOD POOL file and thin out some elements
 
 if not 'EVTMAX' in dir():
     EVTMAX=-1
diff --git a/AtlasTest/PyAthenaTests/share/pythin_mctruth_jobOptions.py b/AtlasTest/PyAthenaTests/share/pythin_mctruth_jobOptions.py
index 465624c65b2..27da11948df 100644
--- a/AtlasTest/PyAthenaTests/share/pythin_mctruth_jobOptions.py
+++ b/AtlasTest/PyAthenaTests/share/pythin_mctruth_jobOptions.py
@@ -1,5 +1,5 @@
 ## @file PyAthenaTests/share/pythin_mctruth_jobOptions.py
-## @purpose read an AOD POOL file and slim the truth
+## @brief read an AOD POOL file and slim the truth
 
 ###################################
 if not 'EVTMAX' in dir():
diff --git a/AtlasTest/PyAthenaTests/share/pythin_multistream_checker_jobOptions.py b/AtlasTest/PyAthenaTests/share/pythin_multistream_checker_jobOptions.py
index 09cbf29ed3d..98198e4b52c 100644
--- a/AtlasTest/PyAthenaTests/share/pythin_multistream_checker_jobOptions.py
+++ b/AtlasTest/PyAthenaTests/share/pythin_multistream_checker_jobOptions.py
@@ -1,5 +1,5 @@
 ## @file PyAthenaTests/share/pythin_multistream_checker_jobOptions.py
-## @purpose read a POOL file and inspect possibly thinned containers
+## @brief read a POOL file and inspect possibly thinned containers
 
 ###############################################
 if not 'EVTMAX' in dir():
diff --git a/AtlasTest/PyAthenaTests/share/pythin_multistream_jobOptions.py b/AtlasTest/PyAthenaTests/share/pythin_multistream_jobOptions.py
index 4b361bbba68..ef7612b239b 100644
--- a/AtlasTest/PyAthenaTests/share/pythin_multistream_jobOptions.py
+++ b/AtlasTest/PyAthenaTests/share/pythin_multistream_jobOptions.py
@@ -1,5 +1,5 @@
 ## @file PyAthenaTests/share/pythin_multistream_jobOptions.py
-## @purpose read a POOL file and thin out some elements
+## @brief read a POOL file and thin out some elements
 
 ###############################################
 if not 'EVTMAX' in dir():
diff --git a/Control/AthenaCommon/python/AthenaCommonFlags.py b/Control/AthenaCommon/python/AthenaCommonFlags.py
index 95d73b58dfa..f7fd798b37d 100755
--- a/Control/AthenaCommon/python/AthenaCommonFlags.py
+++ b/Control/AthenaCommon/python/AthenaCommonFlags.py
@@ -2,7 +2,7 @@
 
 ##
 ## @file AthenaCommon/python/AthenaCommonFlags.py
-## @purpose Python module to hold common flags to configure JobOptions
+## @brief Python module to hold common flags to configure JobOptions
 ##
 
 """ AthenaCommonFlags
diff --git a/Control/AthenaCommon/python/GlobalFlags.py b/Control/AthenaCommon/python/GlobalFlags.py
index 22d8e6066a4..01e89dee556 100755
--- a/Control/AthenaCommon/python/GlobalFlags.py
+++ b/Control/AthenaCommon/python/GlobalFlags.py
@@ -3,7 +3,7 @@
 ###############################################################################
 ##
 ## @file AthenaCommon/python/GlobalFlags.py
-## @purpose Python module to hold common flags to configure JobOptions
+## @brief Python module to hold common flags to configure JobOptions
 ##
 
 """ GlobalFlags
diff --git a/Control/AthenaCommon/python/PoolInputFileListBase.py b/Control/AthenaCommon/python/PoolInputFileListBase.py
index e212a5ad63f..b0de7815ea1 100644
--- a/Control/AthenaCommon/python/PoolInputFileListBase.py
+++ b/Control/AthenaCommon/python/PoolInputFileListBase.py
@@ -2,7 +2,7 @@
 
 ##
 ## @file AthenaCommon/python/PoolInputFileListBase.py
-## @purpose base class for POOL input file list properties
+## @brief base class for POOL input file list properties
 ##
 from JobProperties import JobProperty
 class PoolInputFileListBase(JobProperty):
diff --git a/DataQuality/dqm_algorithms/dqm_algorithms/GrubbsOutlierTest.h b/DataQuality/dqm_algorithms/dqm_algorithms/GrubbsOutlierTest.h
index fc166236cbf..e1c7e1473b9 100644
--- a/DataQuality/dqm_algorithms/dqm_algorithms/GrubbsOutlierTest.h
+++ b/DataQuality/dqm_algorithms/dqm_algorithms/GrubbsOutlierTest.h
@@ -4,7 +4,7 @@
 
 /*! \file GrubbsOutlierTest.h
  *  \author Venkatesh Kaushik <venkat.kaushik@cern.ch>
- *  \identify outlier-bins in 1d histogram
+ *  @brief outlier-bins in 1d histogram
 */
 
 #ifndef DQM_ALGORITHMS_GRUBBSOUTLIERTEST_H
diff --git a/DataQuality/dqm_algorithms/src/Chi2Test_2D.cxx b/DataQuality/dqm_algorithms/src/Chi2Test_2D.cxx
index 3ff8c0920fd..f046b4aea7d 100644
--- a/DataQuality/dqm_algorithms/src/Chi2Test_2D.cxx
+++ b/DataQuality/dqm_algorithms/src/Chi2Test_2D.cxx
@@ -4,7 +4,7 @@
 
 /*! \file Chi2Test_2D.cxx does Chi2Test on a 2D histogram, and also returns the positions of the highest outlying bins; returns dqm_core::Result
  //result is based on the number of outlying bins above NSigma, not on the chisq/ndf value
- \Written by Ian Moult
+ @author Ian Moult
  */
 
 #include <dqm_core/AlgorithmConfig.h>
diff --git a/DataQuality/dqm_algorithms/src/GrubbsOutlierTest.cxx b/DataQuality/dqm_algorithms/src/GrubbsOutlierTest.cxx
index 992a3c3fecb..a8f4c434397 100644
--- a/DataQuality/dqm_algorithms/src/GrubbsOutlierTest.cxx
+++ b/DataQuality/dqm_algorithms/src/GrubbsOutlierTest.cxx
@@ -3,7 +3,7 @@
 */
 
 /*! \file GrubbsOutlierTest.cxx
- *  \description Determine outliers at a given significance level by defining the Grubbs test
+ *               Determine outliers at a given significance level by defining the Grubbs test
  *               statistic, and finding out the probability of each bin being an outlier. The
  *               critical value is computed for each bin and the probability is estimated 
  *               using the two tailed students T distribution. If the probability for a given bin 
diff --git a/Database/EventIndex/EventIndexProducer/share/POOL2EI_joboptions.py b/Database/EventIndex/EventIndexProducer/share/POOL2EI_joboptions.py
index cca8d21443f..0c63aeb1227 100644
--- a/Database/EventIndex/EventIndexProducer/share/POOL2EI_joboptions.py
+++ b/Database/EventIndex/EventIndexProducer/share/POOL2EI_joboptions.py
@@ -1,5 +1,5 @@
 ## @file: POOL2EI_joboptions.py
-## @purpose: simple joboptions to convert AOD to EI
+## @brief: simple joboptions to convert AOD to EI
 ## @date Feb 2014
 ## @author Javier Sanchez <Javier.Sanchez@ific.uv.es>
 
diff --git a/DetectorDescription/GeoModel/AtlasGeoModel/python/GeoModelInit.py b/DetectorDescription/GeoModel/AtlasGeoModel/python/GeoModelInit.py
index 0c2619d703f..8b1d7599900 100755
--- a/DetectorDescription/GeoModel/AtlasGeoModel/python/GeoModelInit.py
+++ b/DetectorDescription/GeoModel/AtlasGeoModel/python/GeoModelInit.py
@@ -1,7 +1,7 @@
 # Copyright (C) 2002-2017 CERN for the benefit of the ATLAS collaboration
 
 ## @file: AtlasGeoModel/python/GeoModelInit.py
-## @purpose: encapsulate GeoModel configuration
+## @brief: Encapsulate GeoModel configuration
  
 def _setupGeoModel():
     from AthenaCommon.JobProperties import jobproperties
diff --git a/Generators/McAsciiEventSelector/python/ReadMcAscii.py b/Generators/McAsciiEventSelector/python/ReadMcAscii.py
index cd32d8b7b3b..a0bcb8fc0ec 100644
--- a/Generators/McAsciiEventSelector/python/ReadMcAscii.py
+++ b/Generators/McAsciiEventSelector/python/ReadMcAscii.py
@@ -1,7 +1,7 @@
 # Copyright (C) 2002-2017 CERN for the benefit of the ATLAS collaboration
 
 ## @file McAsciiEventSelector/python/ReadMcAscii.py
-## @purpose: install the McAsciiEventSelector
+## @brief: install the McAsciiEventSelector
 
 def _loadReadMcAscii():
     import AthenaCommon.AtlasUnixStandardJob
diff --git a/InnerDetector/InDetEventCnv/InDetPrepRawDataToxAOD/python/InDetDxAODJobProperties.py b/InnerDetector/InDetEventCnv/InDetPrepRawDataToxAOD/python/InDetDxAODJobProperties.py
index 42382ac5760..f245ac52029 100644
--- a/InnerDetector/InDetEventCnv/InDetPrepRawDataToxAOD/python/InDetDxAODJobProperties.py
+++ b/InnerDetector/InDetEventCnv/InDetPrepRawDataToxAOD/python/InDetDxAODJobProperties.py
@@ -1,7 +1,7 @@
 # Copyright (C) 2002-2017 CERN for the benefit of the ATLAS collaboration
 
 ## @file InDetPrepRawDataToxAOD/python/InDetDxAODJobProperties.py
-## @purpose Python module to hold common flags to configure xAOD-making jobOptions
+## @brief Python module to hold common flags to configure xAOD-making jobOptions
 ##
 
 """ InDetDxAODJobProperties
diff --git a/InnerDetector/InDetEventCnv/InDetPrepRawDataToxAOD/python/SCTxAODJobProperties.py b/InnerDetector/InDetEventCnv/InDetPrepRawDataToxAOD/python/SCTxAODJobProperties.py
index 880fa370370..8a8733d1a6a 100644
--- a/InnerDetector/InDetEventCnv/InDetPrepRawDataToxAOD/python/SCTxAODJobProperties.py
+++ b/InnerDetector/InDetEventCnv/InDetPrepRawDataToxAOD/python/SCTxAODJobProperties.py
@@ -1,7 +1,7 @@
 # Copyright (C) 2002-2017 CERN for the benefit of the ATLAS collaboration
 
 ## @file InDetPrepRawDataToxAOD/python/SCTxAODJobProperties.py
-## @purpose Python module to hold common flags to configure SCT AxAOD-making jobOptions
+## @brief Python module to hold common flags to configure SCT AxAOD-making jobOptions
 ##
 
 """ SCTxAODJobProperties
diff --git a/InnerDetector/InDetExample/InDetRecExample/python/InDetJobProperties.py b/InnerDetector/InDetExample/InDetRecExample/python/InDetJobProperties.py
index 6eb14fe90fb..a8c0ce8fa77 100644
--- a/InnerDetector/InDetExample/InDetRecExample/python/InDetJobProperties.py
+++ b/InnerDetector/InDetExample/InDetRecExample/python/InDetJobProperties.py
@@ -4,7 +4,7 @@
 
 #
 ## @file InDetRecExample/python/InDetJobProperties.py
-## @purpose Python module to hold common flags to configure JobOptions
+## @brief Python module to hold common flags to configure JobOptions
 ##
 
 """ InDetJobProperties
diff --git a/InnerDetector/InDetExample/InDetRecExample/python/InDetKeys.py b/InnerDetector/InDetExample/InDetRecExample/python/InDetKeys.py
index 59846379260..93697c9a775 100644
--- a/InnerDetector/InDetExample/InDetRecExample/python/InDetKeys.py
+++ b/InnerDetector/InDetExample/InDetRecExample/python/InDetKeys.py
@@ -2,7 +2,7 @@
 
 ##
 ## @file InDetRecExample/python/InDetKeys.py
-## @purpose Python module to hold common flags to configure JobOptions
+## @brief Python module to hold common flags to configure JobOptions
 ##
 
 """ InDetContainerKeys
diff --git a/InnerDetector/InDetExample/InDetTrigRecExample/python/InDetTrigFlags.py b/InnerDetector/InDetExample/InDetTrigRecExample/python/InDetTrigFlags.py
index 567fd29925f..d24a248b453 100644
--- a/InnerDetector/InDetExample/InDetTrigRecExample/python/InDetTrigFlags.py
+++ b/InnerDetector/InDetExample/InDetTrigRecExample/python/InDetTrigFlags.py
@@ -2,7 +2,7 @@
 
 ##
 ## @file InDetTrigRecExample/python/InDetTrigFlags.py
-## @purpose link InDetTrigFlags to InDetTRigJobProperties container
+## @brief link InDetTrigFlags to InDetTRigJobProperties container
 ##          automate adding of certain InDetJobProperties
 
 """ InDetTrigFlags
diff --git a/InnerDetector/InDetExample/InDetTrigRecExample/python/InDetTrigJobProperties.py b/InnerDetector/InDetExample/InDetTrigRecExample/python/InDetTrigJobProperties.py
index ca79428eeca..d5a6313a879 100644
--- a/InnerDetector/InDetExample/InDetTrigRecExample/python/InDetTrigJobProperties.py
+++ b/InnerDetector/InDetExample/InDetTrigRecExample/python/InDetTrigJobProperties.py
@@ -2,7 +2,7 @@
 
 ##
 ## @file InDetTrigRecExample/python/InDetTrigJobProperties.py
-## @purpose Python module with InDetTrigJobProperties to hold
+## @brief Python module with InDetTrigJobProperties to hold
 ##          an independent configuration of EFID
 ##          some classes need to be duplicated from InDetJobProperties 
 
diff --git a/InnerDetector/InDetExample/InDetTrigRecExample/python/InDetTrigSliceSettings.py b/InnerDetector/InDetExample/InDetTrigRecExample/python/InDetTrigSliceSettings.py
index 26983ce462e..1878e0f9e44 100644
--- a/InnerDetector/InDetExample/InDetTrigRecExample/python/InDetTrigSliceSettings.py
+++ b/InnerDetector/InDetExample/InDetTrigRecExample/python/InDetTrigSliceSettings.py
@@ -2,7 +2,6 @@
 
 ##
 ## @file InDetTrigRecExample/python/InDetTrigSliceSettings.py
-## @purpose 
 ##
 ##
 
diff --git a/MuonSpectrometer/MuonValidation/MuonDQA/MuonDQAMonFlags/python/MuonDQAProperFlags.py b/MuonSpectrometer/MuonValidation/MuonDQA/MuonDQAMonFlags/python/MuonDQAProperFlags.py
index b61bdd314df..07bccdde492 100644
--- a/MuonSpectrometer/MuonValidation/MuonDQA/MuonDQAMonFlags/python/MuonDQAProperFlags.py
+++ b/MuonSpectrometer/MuonValidation/MuonDQA/MuonDQAMonFlags/python/MuonDQAProperFlags.py
@@ -2,7 +2,7 @@
 
 ##
 ## @file MuonDQAMonFlags/python/MuonDQAProperFlags.py
-## @purpose Python module to hold common flags to configure JobOptions
+## @brief Python module to hold common flags to configure JobOptions
 ##
 
 """ MuonDQAProperFlags
diff --git a/PhysicsAnalysis/D3PDMaker/MuonD3PDMaker/python/MuonD3PDMakerFlags.py b/PhysicsAnalysis/D3PDMaker/MuonD3PDMaker/python/MuonD3PDMakerFlags.py
index 99526390656..0b5521b9b60 100644
--- a/PhysicsAnalysis/D3PDMaker/MuonD3PDMaker/python/MuonD3PDMakerFlags.py
+++ b/PhysicsAnalysis/D3PDMaker/MuonD3PDMaker/python/MuonD3PDMakerFlags.py
@@ -2,7 +2,7 @@
 
 # 
 ## @file MuonD3PDMaker/python/MuonD3PDMakerFlags.py
-## @purpose Python module to hold common flags to configure MuonD3PDMaker JobOptions
+## @brief Python module to hold common flags to configure MuonD3PDMaker JobOptions
 ##
 
 
diff --git a/PhysicsAnalysis/D3PDMaker/TrackD3PDMaker/python/TrackD3PDMakerFlags.py b/PhysicsAnalysis/D3PDMaker/TrackD3PDMaker/python/TrackD3PDMakerFlags.py
index 5c10b65e264..04d2b372610 100644
--- a/PhysicsAnalysis/D3PDMaker/TrackD3PDMaker/python/TrackD3PDMakerFlags.py
+++ b/PhysicsAnalysis/D3PDMaker/TrackD3PDMaker/python/TrackD3PDMakerFlags.py
@@ -2,7 +2,7 @@
 
 # 
 ## @file TrackD3PDMaker/python/TrackD3PDMakerFlags.py
-## @purpose Python module to hold common flags to configure TrackD3PDMaker JobOptions
+## @brief Python module to hold common flags to configure TrackD3PDMaker JobOptions
 ##
 
 
diff --git a/PhysicsAnalysis/D3PDMaker/TrackD3PDMaker/python/TrackD3PDMakerPixelFlags.py b/PhysicsAnalysis/D3PDMaker/TrackD3PDMaker/python/TrackD3PDMakerPixelFlags.py
index 411e8d04975..a2c7d46f022 100644
--- a/PhysicsAnalysis/D3PDMaker/TrackD3PDMaker/python/TrackD3PDMakerPixelFlags.py
+++ b/PhysicsAnalysis/D3PDMaker/TrackD3PDMaker/python/TrackD3PDMakerPixelFlags.py
@@ -2,7 +2,7 @@
 
 # 
 ## @file TrackD3PDMaker/python/TrackD3PDMakerPixelFlags.py
-## @purpose Python module to hold common flags to configure TrackD3PDMaker PixelNtuple JobOptions
+## @brief Python module to hold common flags to configure TrackD3PDMaker PixelNtuple JobOptions
 ##
 
 
diff --git a/PhysicsAnalysis/D3PDMaker/TrackD3PDMaker/python/TrackD3PDMakerSCTFlags.py b/PhysicsAnalysis/D3PDMaker/TrackD3PDMaker/python/TrackD3PDMakerSCTFlags.py
index 17fe10deccf..4f24374f879 100644
--- a/PhysicsAnalysis/D3PDMaker/TrackD3PDMaker/python/TrackD3PDMakerSCTFlags.py
+++ b/PhysicsAnalysis/D3PDMaker/TrackD3PDMaker/python/TrackD3PDMakerSCTFlags.py
@@ -2,7 +2,7 @@
 
 # 
 ## @file TrackD3PDMaker/python/TrackD3PDMakerSCTFlags.py
-## @purpose Python module to hold common flags to configure TrackD3PDMaker SCTNtuple JobOptions
+## @brief Python module to hold common flags to configure TrackD3PDMaker SCTNtuple JobOptions
 ##
 
 
diff --git a/PhysicsAnalysis/D3PDMaker/TrackD3PDMaker/src/SCTTrackParticleToMuonAssociationTool.h b/PhysicsAnalysis/D3PDMaker/TrackD3PDMaker/src/SCTTrackParticleToMuonAssociationTool.h
index 65c398cc4b6..7a2730050ce 100644
--- a/PhysicsAnalysis/D3PDMaker/TrackD3PDMaker/src/SCTTrackParticleToMuonAssociationTool.h
+++ b/PhysicsAnalysis/D3PDMaker/TrackD3PDMaker/src/SCTTrackParticleToMuonAssociationTool.h
@@ -4,7 +4,7 @@
 
 /**
  * @file D3PDMaker/TrackD3PDMaker/src/SCTTrackParticleToMuonAssociationTool.cxx
- * @contact <laura.rehnisch@cern.ch>
+ * @author <laura.rehnisch@cern.ch>
  * @date Nov, 2012
  * @brief setting up an association of trackparticles
  *        and muons.
diff --git a/PhysicsAnalysis/D3PDMaker/TrackD3PDMaker/src/TrackParticleToPixelClusterAssociationTool.h b/PhysicsAnalysis/D3PDMaker/TrackD3PDMaker/src/TrackParticleToPixelClusterAssociationTool.h
index 618498c545f..4ad6c8b7f1b 100644
--- a/PhysicsAnalysis/D3PDMaker/TrackD3PDMaker/src/TrackParticleToPixelClusterAssociationTool.h
+++ b/PhysicsAnalysis/D3PDMaker/TrackD3PDMaker/src/TrackParticleToPixelClusterAssociationTool.h
@@ -4,7 +4,7 @@
 
 /**
 * @file D3PDMaker/TrackD3PDMaker/src/TrackParticleToPixelClusterAssociationTool.cxx
-* @contact <yuriy.pylypchenko@cern.ch>
+* @author <yuriy.pylypchenko@cern.ch>
 * @date Oct, 2010
 * @brief setting up an association of tracks to clusters
 *        represented by indices. 
diff --git a/PhysicsAnalysis/D3PDMaker/TrackD3PDMaker/src/TrackParticleToSCTClusterAssociationTool.h b/PhysicsAnalysis/D3PDMaker/TrackD3PDMaker/src/TrackParticleToSCTClusterAssociationTool.h
index acf36a47642..673badee817 100644
--- a/PhysicsAnalysis/D3PDMaker/TrackD3PDMaker/src/TrackParticleToSCTClusterAssociationTool.h
+++ b/PhysicsAnalysis/D3PDMaker/TrackD3PDMaker/src/TrackParticleToSCTClusterAssociationTool.h
@@ -4,7 +4,7 @@
 
 /**
 * @file D3PDMaker/TrackD3PDMaker/src/TrackParticleToSCTClusterAssociationTool.cxx
-* @contact <yuriy.pylypchenko@cern.ch>
+* @author <yuriy.pylypchenko@cern.ch>
 * @date Oct, 2010
 * @brief setting up an association of tracks to clusters
 *        represented by indices. 
diff --git a/PhysicsAnalysis/PanTauAnalysis/python/PanTauDPDFlags.py b/PhysicsAnalysis/PanTauAnalysis/python/PanTauDPDFlags.py
index 37805132fca..fa6c3ac3e59 100644
--- a/PhysicsAnalysis/PanTauAnalysis/python/PanTauDPDFlags.py
+++ b/PhysicsAnalysis/PanTauAnalysis/python/PanTauDPDFlags.py
@@ -2,7 +2,7 @@
 
 ##
 ## @file PanTauAnalysis/python/PanTauDPDFlags.py
-## @purpose Python module to hold common flags to configure PanTau DPD writing
+## @brief Python module to hold common flags to configure PanTau DPD writing
 ##
 
 """ PanTauDPDFlags
diff --git a/PhysicsAnalysis/PanTauAnalysis/python/PanTauFlags.py b/PhysicsAnalysis/PanTauAnalysis/python/PanTauFlags.py
index aa73fa94b29..de3612ea3c1 100644
--- a/PhysicsAnalysis/PanTauAnalysis/python/PanTauFlags.py
+++ b/PhysicsAnalysis/PanTauAnalysis/python/PanTauFlags.py
@@ -2,7 +2,7 @@
 
 ##
 ## @file PanTauAnalysis/python/PanTauFlags.py
-## @purpose Python module to hold common flags to configure PanTau
+## @brief Python module to hold common flags to configure PanTau
 ##
 
 """ PanTauFlags
diff --git a/PhysicsAnalysis/PanTauAnalysis/python/PanTauSeedBuilderAlg_Flags.py b/PhysicsAnalysis/PanTauAnalysis/python/PanTauSeedBuilderAlg_Flags.py
index 5bef3979aac..e1369afdeaa 100644
--- a/PhysicsAnalysis/PanTauAnalysis/python/PanTauSeedBuilderAlg_Flags.py
+++ b/PhysicsAnalysis/PanTauAnalysis/python/PanTauSeedBuilderAlg_Flags.py
@@ -2,7 +2,7 @@
 
 ##
 ## @file PanTauAnalysis/python/PanTauSeedBuilderAlg_Flags.py
-## @purpose Python module to hold the flags that configure the TauSeedBuilderAlg
+## @brief Python module to hold the flags that configure the TauSeedBuilderAlg
 ##
 
 """ PanTauSeedBuilderAlg_Flags
diff --git a/PhysicsAnalysis/PanTauAnalysis/python/PanTauValidationFlags.py b/PhysicsAnalysis/PanTauAnalysis/python/PanTauValidationFlags.py
index 291b6b5150f..6e9af42ee34 100644
--- a/PhysicsAnalysis/PanTauAnalysis/python/PanTauValidationFlags.py
+++ b/PhysicsAnalysis/PanTauAnalysis/python/PanTauValidationFlags.py
@@ -2,7 +2,7 @@
 
 ##
 ## @file PanTauAnalysis/python/PanTauValidationFlags.py
-## @purpose Python module to hold common flags to configure PanTau validation
+## @brief Python module to hold common flags to configure PanTau validation
 ##
 
 """ PanTauValidationFlags
diff --git a/Reconstruction/MuonIdentification/MuonCombinedRecExample/python/MuonCombinedKeys.py b/Reconstruction/MuonIdentification/MuonCombinedRecExample/python/MuonCombinedKeys.py
index 32ab4806654..2a9e0540934 100644
--- a/Reconstruction/MuonIdentification/MuonCombinedRecExample/python/MuonCombinedKeys.py
+++ b/Reconstruction/MuonIdentification/MuonCombinedRecExample/python/MuonCombinedKeys.py
@@ -2,7 +2,7 @@
 
 ##
 ## @file MuonCombinedRecExample/python/MuonCombinedKeys.py
-## @purpose Python module to hold uniform collection names for muon combined reconstruction
+## @brief Python module to hold uniform collection names for muon combined reconstruction
 ##
 
 """ MuonCombinedContainerKeys
diff --git a/Simulation/ISF/ISF_Config/python/ISF_jobProperties.py b/Simulation/ISF/ISF_Config/python/ISF_jobProperties.py
index 00c35dd7891..114852f0620 100644
--- a/Simulation/ISF/ISF_Config/python/ISF_jobProperties.py
+++ b/Simulation/ISF/ISF_Config/python/ISF_jobProperties.py
@@ -1,7 +1,7 @@
 # Copyright (C) 2002-2017 CERN for the benefit of the ATLAS collaboration
 
 ## @file ISF_Config/python/ISF_jobProperties.py
-## @purpose Python module to hold common flags to configure JobOptions
+## @brief Python module to hold common flags to configure JobOptions
 ##
 
 """ ISF_jobProperties
diff --git a/Simulation/ISF/ISF_FastCaloSim/ISF_FastCaloSimParametrization/python/ISF_NativeFastCaloSimJobProperties.py b/Simulation/ISF/ISF_FastCaloSim/ISF_FastCaloSimParametrization/python/ISF_NativeFastCaloSimJobProperties.py
index 27c63982094..0026b722c1b 100644
--- a/Simulation/ISF/ISF_FastCaloSim/ISF_FastCaloSimParametrization/python/ISF_NativeFastCaloSimJobProperties.py
+++ b/Simulation/ISF/ISF_FastCaloSim/ISF_FastCaloSimParametrization/python/ISF_NativeFastCaloSimJobProperties.py
@@ -1,7 +1,7 @@
 # Copyright (C) 2002-2017 CERN for the benefit of the ATLAS collaboration
 
 ## @file ISF_NativeFastCaloSimJobProperties.py
-## @purpose Python module to hold common flags to configure JobOptions
+## @brief Python module to hold common flags to configure JobOptions
 ##
 
 """ ISF_NativeFastCaloSimJobProperties
diff --git a/Simulation/ISF/ISF_FastCaloSim/ISF_FastCaloSimServices/python/ISF_FastCaloSimJobProperties.py b/Simulation/ISF/ISF_FastCaloSim/ISF_FastCaloSimServices/python/ISF_FastCaloSimJobProperties.py
index 770d62e26f9..e19d1e039b1 100644
--- a/Simulation/ISF/ISF_FastCaloSim/ISF_FastCaloSimServices/python/ISF_FastCaloSimJobProperties.py
+++ b/Simulation/ISF/ISF_FastCaloSim/ISF_FastCaloSimServices/python/ISF_FastCaloSimJobProperties.py
@@ -1,7 +1,7 @@
 # Copyright (C) 2002-2017 CERN for the benefit of the ATLAS collaboration
 
 ## @file ISF_FastCaloSimJobProperties.py
-## @purpose Python module to hold common flags to configure JobOptions
+## @brief Python module to hold common flags to configure JobOptions
 ##
 
 """ ISF_FastCaloSimJobProperties
diff --git a/Simulation/ISF/ISF_Fatras/ISF_FatrasServices/python/ISF_FatrasJobProperties.py b/Simulation/ISF/ISF_Fatras/ISF_FatrasServices/python/ISF_FatrasJobProperties.py
index 29c4c5ee8ea..c8a5efcaa73 100644
--- a/Simulation/ISF/ISF_Fatras/ISF_FatrasServices/python/ISF_FatrasJobProperties.py
+++ b/Simulation/ISF/ISF_Fatras/ISF_FatrasServices/python/ISF_FatrasJobProperties.py
@@ -1,7 +1,7 @@
 # Copyright (C) 2002-2017 CERN for the benefit of the ATLAS collaboration
 
 ## @file ISF_FatrasJobProperties.py
-## @purpose Python module to hold common flags to configure JobOptions
+## @brief Python module to hold common flags to configure JobOptions
 ##
 
 """ ISF_FatrasJobProperties
diff --git a/Simulation/ISF/ISF_ParametricSim/ISF_ParSimServices/python/ISF_ParSimJobProperties.py b/Simulation/ISF/ISF_ParametricSim/ISF_ParSimServices/python/ISF_ParSimJobProperties.py
index 01513e170c5..3de38efd15d 100644
--- a/Simulation/ISF/ISF_ParametricSim/ISF_ParSimServices/python/ISF_ParSimJobProperties.py
+++ b/Simulation/ISF/ISF_ParametricSim/ISF_ParSimServices/python/ISF_ParSimJobProperties.py
@@ -1,7 +1,7 @@
 # Copyright (C) 2002-2017 CERN for the benefit of the ATLAS collaboration
 
 ## @file ISF_ParSimJobProperties.py
-## @purpose Python module to hold common flags to configure JobOptions
+## @brief Python module to hold common flags to configure JobOptions
 ##
 
 __author__ = "Miha Muskinja"
diff --git a/Simulation/ISF/ISF_ParametricSim/ISF_ParSimServices/python/ISF_ParSimTuning.py b/Simulation/ISF/ISF_ParametricSim/ISF_ParSimServices/python/ISF_ParSimTuning.py
index eca0b82c9c0..9196b0f4bdc 100644
--- a/Simulation/ISF/ISF_ParametricSim/ISF_ParSimServices/python/ISF_ParSimTuning.py
+++ b/Simulation/ISF/ISF_ParametricSim/ISF_ParSimServices/python/ISF_ParSimTuning.py
@@ -1,7 +1,7 @@
 # Copyright (C) 2002-2017 CERN for the benefit of the ATLAS collaboration
 
 ## @file ISF_ParSimTuning.py
-## @purpose Python module to hold common flags to configure JobOptions
+## @brief Python module to hold common flags to configure JobOptions
 ##
 
 __author__ = "Miha Muskinja"
diff --git a/Tools/PyUtils/bin/checkPlugins.py b/Tools/PyUtils/bin/checkPlugins.py
index a11c87d91d4..516bf7714a4 100755
--- a/Tools/PyUtils/bin/checkPlugins.py
+++ b/Tools/PyUtils/bin/checkPlugins.py
@@ -4,7 +4,7 @@
 
 ## @author: Sebastien Binet
 ## @file : checkPlugins.py
-## @purpose: a script to check the definitions of plugins across multiple
+## @brief: A script to check the definitions of plugins across multiple
 ##           so-called 'rootmap' files
 
 __version__ = "$Revision: 1.3 $"
diff --git a/Tools/PyUtils/bin/cmtClients.py b/Tools/PyUtils/bin/cmtClients.py
index 7145e110ab6..673aadafcb1 100755
--- a/Tools/PyUtils/bin/cmtClients.py
+++ b/Tools/PyUtils/bin/cmtClients.py
@@ -4,7 +4,7 @@
 
 ## @author: Sebastien Binet
 ## @file : cmtClients.py
-## @purpose: a little wrapper around cmt.exe show clients
+## @brief: A little wrapper around cmt.exe show clients
 
 __version__ = "$Revision: 1.4 $"
 __author__  = "Sebastien Binet"
diff --git a/Tools/PyUtils/bin/filter-and-merge-d3pd.py b/Tools/PyUtils/bin/filter-and-merge-d3pd.py
index 03dd855ecf3..33d28d61208 100755
--- a/Tools/PyUtils/bin/filter-and-merge-d3pd.py
+++ b/Tools/PyUtils/bin/filter-and-merge-d3pd.py
@@ -751,7 +751,7 @@ Accepted command line options:
 
 ###################### xmldict #########################
 # @file PyUtils/python/xmldict.py
-# @purpose converts an XML file into a python dict, back and forth
+# @brief converts an XML file into a python dict, back and forth
 # @author http://code.activestate.com/recipes/573463
 #         slightly adapted to follow PEP8 conventions
 
diff --git a/Tools/PyUtils/bin/merge-poolfiles.py b/Tools/PyUtils/bin/merge-poolfiles.py
index 0ab80663164..a67fab07b6c 100755
--- a/Tools/PyUtils/bin/merge-poolfiles.py
+++ b/Tools/PyUtils/bin/merge-poolfiles.py
@@ -2,7 +2,7 @@
 
 # Copyright (C) 2002-2017 CERN for the benefit of the ATLAS collaboration
 ## @file PyUtils/bin/merge-poolfiles.py
-## @purpose take a bunch of input pool files and produce a single one
+## @brief take a bunch of input pool files and produce a single one
 ##          autoconfiguration is (attempted to be) performed
 ## @author Sebastien Binet <binet@cern.ch>
 
diff --git a/Tracking/TrkDetDescr/TrkDetDescrSvc/python/TrkDetDescrJobProperties.py b/Tracking/TrkDetDescr/TrkDetDescrSvc/python/TrkDetDescrJobProperties.py
index 9b07943c456..ad424c73397 100644
--- a/Tracking/TrkDetDescr/TrkDetDescrSvc/python/TrkDetDescrJobProperties.py
+++ b/Tracking/TrkDetDescr/TrkDetDescrSvc/python/TrkDetDescrJobProperties.py
@@ -2,7 +2,7 @@
 
 #
 ## @file TrkDetDescrSvc/python/TrkDetDescrJobProperties.py
-## @purpose Python module to hold common flags to configure JobOptions
+## @brief Python module to hold common flags to configure JobOptions
 ##
 
 """ TrkDetDescrJobProperties
diff --git a/Trigger/TrigAlgorithms/TrigMinBias/python/TrigMinBiasProperties.py b/Trigger/TrigAlgorithms/TrigMinBias/python/TrigMinBiasProperties.py
index 2c4bf8a49f4..01a00dff424 100644
--- a/Trigger/TrigAlgorithms/TrigMinBias/python/TrigMinBiasProperties.py
+++ b/Trigger/TrigAlgorithms/TrigMinBias/python/TrigMinBiasProperties.py
@@ -2,7 +2,7 @@
 
 ##
 ## @file Trigger/TrigAlgorithms/TrigMinBias/python/TrigMinBiasProperties.py
-## @purpose Python module to hold TrigHisto1D and TrigHisto2D histogram dimensions.  The dimensions are used to initialise the TrigMinBias algorithms and the associated monitoring.
+## @brief Python module to hold TrigHisto1D and TrigHisto2D histogram dimensions.  The dimensions are used to initialise the TrigMinBias algorithms and the associated monitoring.
 ##
 ## Adapted from AthenaCommonFlags.py
 ##
diff --git a/Trigger/TrigAlgorithms/TrigT2MinBias/python/TrigT2MinBiasProperties.py b/Trigger/TrigAlgorithms/TrigT2MinBias/python/TrigT2MinBiasProperties.py
index 36b80475a6f..706bb149618 100644
--- a/Trigger/TrigAlgorithms/TrigT2MinBias/python/TrigT2MinBiasProperties.py
+++ b/Trigger/TrigAlgorithms/TrigT2MinBias/python/TrigT2MinBiasProperties.py
@@ -2,7 +2,7 @@
 
 ##
 ## @file Trigger/TrigAlgorithms/TrigT2MinBias/python/TrigT2MinBiasProperties.py
-## @purpose Python module to hold TrigHisto1D and TrigHisto2D histogram dimensions.  The dimensions are used to initialise the TrigT2MinBias algorithms and the associated monitoring.
+## @brief Python module to hold TrigHisto1D and TrigHisto2D histogram dimensions.  The dimensions are used to initialise the TrigT2MinBias algorithms and the associated monitoring.
 ##
 ## Adapted from AthenaCommonFlags.py
 ##
-- 
GitLab