[PATCH] Remove explicit file names from @file

Joel Sherrill joel at rtems.org
Wed Feb 27 14:55:57 UTC 2019


I'm OK with this but not with removing @brief's

On Wed, Feb 27, 2019 at 4:01 AM Sebastian Huber <
sebastian.huber at embedded-brains.de> wrote:

> This makes the @file documentation independent of the actual file name.
>
> Update #3707.
> ---
>  bsps/arm/include/bsp/arm-errata.h                        | 2 +-
>  bsps/arm/include/bsp/arm-release-id.h                    | 2 +-
>  bsps/arm/include/cmsis_gcc.h                             | 2 +-
>  bsps/arm/include/core_cm7.h                              | 2 +-
>  bsps/arm/include/core_cmFunc.h                           | 2 +-
>  bsps/arm/include/core_cmInstr.h                          | 2 +-
>  bsps/arm/include/core_cmSimd.h                           | 2 +-
>  bsps/arm/lpc176x/btimer/btimer.c                         | 2 +-
>  bsps/arm/lpc176x/can/can.c                               | 2 +-
>  bsps/arm/lpc176x/gpio/lpc-gpio.c                         | 2 +-
>  bsps/arm/lpc176x/include/bsp/adc-defs.h                  | 2 +-
>  bsps/arm/lpc176x/include/bsp/adc.h                       | 2 +-
>  bsps/arm/lpc176x/include/bsp/can-defs.h                  | 2 +-
>  bsps/arm/lpc176x/include/bsp/can.h                       | 2 +-
>  bsps/arm/lpc176x/include/bsp/common-types.h              | 2 +-
>  bsps/arm/lpc176x/include/bsp/gpio-defs.h                 | 2 +-
>  bsps/arm/lpc176x/include/bsp/io-defs.h                   | 2 +-
>  bsps/arm/lpc176x/include/bsp/io.h                        | 2 +-
>  bsps/arm/lpc176x/include/bsp/lpc-gpio.h                  | 2 +-
>  bsps/arm/lpc176x/include/bsp/lpc176x.h                   | 2 +-
>  bsps/arm/lpc176x/include/bsp/mbed-pinmap.h               | 2 +-
>  bsps/arm/lpc176x/include/bsp/pwmout-defs.h               | 2 +-
>  bsps/arm/lpc176x/include/bsp/pwmout.h                    | 2 +-
>  bsps/arm/lpc176x/include/bsp/timer-defs.h                | 2 +-
>  bsps/arm/lpc176x/include/bsp/timer.h                     | 2 +-
>  bsps/arm/lpc176x/include/bsp/watchdog-defs.h             | 2 +-
>  bsps/arm/lpc176x/include/bsp/watchdog.h                  | 2 +-
>  bsps/arm/lpc176x/pwm/pwmout.c                            | 2 +-
>  bsps/arm/lpc176x/start/adc.c                             | 2 +-
>  bsps/arm/lpc176x/start/bspstarthooks.c                   | 2 +-
>  bsps/arm/lpc176x/start/io.c                              | 2 +-
>  bsps/arm/lpc176x/start/watchdog.c                        | 2 +-
>  bsps/arm/lpc176x/timer/timer.c                           | 2 +-
>  bsps/arm/lpc32xx/include/tm27.h                          | 2 +-
>  bsps/arm/raspberrypi/gpio/gpio-interfaces-pi1-rev2.c     | 2 +-
>  bsps/arm/raspberrypi/gpio/rpi-gpio.c                     | 2 +-
>  bsps/arm/raspberrypi/i2c/i2c.c                           | 2 +-
>  bsps/arm/raspberrypi/include/bsp/i2c.h                   | 2 +-
>  bsps/arm/raspberrypi/include/bsp/raspberrypi.h           | 2 +-
>  bsps/arm/raspberrypi/include/bsp/rpi-gpio.h              | 2 +-
>  bsps/arm/raspberrypi/include/bsp/spi.h                   | 2 +-
>  bsps/arm/raspberrypi/irq/irq.c                           | 2 +-
>  bsps/arm/raspberrypi/spi/spi.c                           | 2 +-
>  bsps/arm/shared/start/bsp-start-init-registers.S         | 2 +-
>  bsps/arm/tms570/clock/clock.c                            | 2 +-
>  bsps/arm/tms570/console/printk-support.c                 | 2 +-
>  bsps/arm/tms570/console/tms570-sci.c                     | 2 +-
>  bsps/arm/tms570/include/bsp.h                            | 2 +-
>  bsps/arm/tms570/include/bsp/irq.h                        | 2 +-
>  bsps/arm/tms570/include/bsp/system-clocks.h              | 2 +-
>  bsps/arm/tms570/include/bsp/tms570-pinmux.h              | 2 +-
>  bsps/arm/tms570/include/bsp/tms570-pins.h                | 2 +-
>  bsps/arm/tms570/include/bsp/tms570-pom.h                 | 2 +-
>  bsps/arm/tms570/include/bsp/tms570-rti.h                 | 2 +-
>  bsps/arm/tms570/include/bsp/tms570-sci-driver.h          | 2 +-
>  bsps/arm/tms570/include/bsp/tms570-sci.h                 | 2 +-
>  bsps/arm/tms570/include/bsp/tms570-vim.h                 | 2 +-
>  bsps/arm/tms570/include/bsp/tms570_selftest.h            | 2 +-
>  bsps/arm/tms570/include/bsp/tms570_selftest_parity.h     | 2 +-
>  bsps/arm/tms570/include/bsp/tms570lc4357-pins.h          | 2 +-
>  bsps/arm/tms570/include/bsp/tms570ls3137zwt-pins.h       | 2 +-
>  bsps/arm/tms570/irq/irq.c                                | 2 +-
>  bsps/arm/tms570/start/bspreset.c                         | 2 +-
>  bsps/arm/tms570/start/bspstart.c                         | 2 +-
>  bsps/arm/tms570/start/bspstarthooks.c                    | 2 +-
>  bsps/arm/tms570/start/init_emif_sdram.c                  | 2 +-
>  bsps/arm/tms570/start/init_esm.c                         | 2 +-
>  bsps/arm/tms570/start/init_pinmux.c                      | 2 +-
>  bsps/arm/tms570/start/init_system.c                      | 2 +-
>  bsps/arm/tms570/start/pinmux.c                           | 2 +-
>  bsps/arm/tms570/start/tms570-pom.c                       | 2 +-
>  bsps/arm/tms570/start/tms570_selftest.c                  | 2 +-
>  bsps/arm/tms570/start/tms570_selftest_par_can.c          | 2 +-
>  bsps/arm/tms570/start/tms570_selftest_par_mibspi.c       | 2 +-
>  bsps/arm/tms570/start/tms570_selftest_par_std.c          | 2 +-
>  bsps/arm/tms570/start/tms570_selftest_parity.c           | 2 +-
>  bsps/arm/tms570/start/tms570_tcram_tests.c               | 2 +-
>  bsps/bfin/TLL6527M/console/console.c                     | 2 +-
>  bsps/bfin/TLL6527M/include/bsp.h                         | 2 +-
>  bsps/bfin/TLL6527M/start/interrupt.c                     | 2 +-
>  bsps/bfin/include/bf52x.h                                | 2 +-
>  bsps/bfin/include/bsp/interrupt.h                        | 2 +-
>  bsps/i386/include/bsp/realmode_int.h                     | 2 +-
>  bsps/i386/include/libcpu/page.h                          | 2 +-
>  bsps/i386/pc386/console/fb_vesa_rm.c                     | 2 +-
>  bsps/i386/pc386/include/bsp/fb_default_mode.h            | 2 +-
>  bsps/i386/pc386/include/bsp/fb_vesa.h                    | 2 +-
>  bsps/i386/pc386/include/bsp/vbe3.h                       | 2 +-
>  bsps/i386/pc386/include/edid.h                           | 2 +-
>  bsps/i386/pc386/start/realmode_int.c                     | 2 +-
>  bsps/include/bsp/gpio.h                                  | 2 +-
>  bsps/powerpc/include/rtems/powerpc/powerpc.h             | 2 +-
>  bsps/powerpc/virtex4/start/start.S                       | 2 +-
>  bsps/powerpc/virtex5/start/start.S                       | 2 +-
>  bsps/shared/dev/gpio/gpio-support.c                      | 2 +-
>  cpukit/include/memory.h                                  | 2 +-
>  cpukit/include/rtems/assoc.h                             | 2 +-
>  cpukit/include/rtems/bspIo.h                             | 2 +-
>  cpukit/include/rtems/bspcmdline.h                        | 2 +-
>  cpukit/include/rtems/btimer.h                            | 2 +-
>  cpukit/include/rtems/capture-cli.h                       | 2 +-
>  cpukit/include/rtems/capture.h                           | 2 +-
>  cpukit/include/rtems/captureimpl.h                       | 2 +-
>  cpukit/include/rtems/concat.h                            | 2 +-
>  cpukit/include/rtems/cpuuse.h                            | 2 +-
>  cpukit/include/rtems/devfs.h                             | 2 +-
>  cpukit/include/rtems/devzero.h                           | 2 +-
>  cpukit/include/rtems/endian.h                            | 2 +-
>  cpukit/include/rtems/error.h                             | 2 +-
>  cpukit/include/rtems/fb.h                                | 2 +-
>  cpukit/include/rtems/framebuffer.h                       | 2 +-
>  cpukit/include/rtems/fs.h                                | 2 +-
>  cpukit/include/rtems/fsmount.h                           | 2 +-
>  cpukit/include/rtems/gxx_wrappers.h                      | 2 +-
>  cpukit/include/rtems/inttypes.h                          | 2 +-
>  cpukit/include/rtems/iosupp.h                            | 2 +-
>  cpukit/include/rtems/irq.h                               | 2 +-
>  cpukit/include/rtems/malloc.h                            | 2 +-
>  cpukit/include/rtems/monitor.h                           | 2 +-
>  cpukit/include/rtems/mouse_parser.h                      | 2 +-
>  cpukit/include/rtems/mw_uid.h                            | 2 +-
>  cpukit/include/rtems/nvdisk-sram.h                       | 2 +-
>  cpukit/include/rtems/nvdisk.h                            | 2 +-
>  cpukit/include/rtems/pci.h                               | 2 +-
>  cpukit/include/rtems/posix/timer.h                       | 2 +-
>  cpukit/include/rtems/print.h                             | 2 +-
>  cpukit/include/rtems/printer.h                           | 2 +-
>  cpukit/include/rtems/qreslib.h                           | 2 +-
>  cpukit/include/rtems/rtems/asr.h                         | 2 +-
>  cpukit/include/rtems/rtems/attr.h                        | 2 +-
>  cpukit/include/rtems/rtems/clock.h                       | 2 +-
>  cpukit/include/rtems/rtems/config.h                      | 2 +-
>  cpukit/include/rtems/rtems/eventmp.h                     | 2 +-
>  cpukit/include/rtems/rtems/intr.h                        | 2 +-
>  cpukit/include/rtems/rtems/mainpage.h                    | 2 +-
>  cpukit/include/rtems/rtems/modes.h                       | 2 +-
>  cpukit/include/rtems/rtems/mp.h                          | 2 +-
>  cpukit/include/rtems/rtems/msgmp.h                       | 2 +-
>  cpukit/include/rtems/rtems/object.h                      | 2 +-
>  cpukit/include/rtems/rtems/options.h                     | 2 +-
>  cpukit/include/rtems/rtems/partmp.h                      | 2 +-
>  cpukit/include/rtems/rtems/ratemon.h                     | 2 +-
>  cpukit/include/rtems/rtems/semmp.h                       | 2 +-
>  cpukit/include/rtems/rtems/signalmp.h                    | 2 +-
>  cpukit/include/rtems/rtems/status.h                      | 2 +-
>  cpukit/include/rtems/rtems/taskmp.h                      | 2 +-
>  cpukit/include/rtems/score/address.h                     | 2 +-
>  cpukit/include/rtems/score/context.h                     | 2 +-
>  cpukit/include/rtems/score/copyrt.h                      | 2 +-
>  cpukit/include/rtems/score/corebarrier.h                 | 2 +-
>  cpukit/include/rtems/score/coremsg.h                     | 2 +-
>  cpukit/include/rtems/score/coresem.h                     | 2 +-
>  cpukit/include/rtems/score/interr.h                      | 2 +-
>  cpukit/include/rtems/score/isr.h                         | 2 +-
>  cpukit/include/rtems/score/isrlevel.h                    | 2 +-
>  cpukit/include/rtems/score/mppkt.h                       | 2 +-
>  cpukit/include/rtems/score/object.h                      | 2 +-
>  cpukit/include/rtems/score/objectmp.h                    | 2 +-
>  cpukit/include/rtems/score/percpu.h                      | 2 +-
>  cpukit/include/rtems/score/prioritybitmap.h              | 2 +-
>  cpukit/include/rtems/score/rbtree.h                      | 2 +-
>  cpukit/include/rtems/score/scheduler.h                   | 2 +-
>  cpukit/include/rtems/score/schedulercbs.h                | 2 +-
>  cpukit/include/rtems/score/scheduleredf.h                | 2 +-
>  cpukit/include/rtems/score/schedulerpriority.h           | 2 +-
>  cpukit/include/rtems/score/schedulersimple.h             | 2 +-
>  cpukit/include/rtems/score/stack.h                       | 2 +-
>  cpukit/include/rtems/score/states.h                      | 2 +-
>  cpukit/include/rtems/score/thread.h                      | 2 +-
>  cpukit/include/rtems/score/threadmp.h                    | 2 +-
>  cpukit/include/rtems/score/threadqimpl.h                 | 2 +-
>  cpukit/include/rtems/score/timespec.h                    | 2 +-
>  cpukit/include/rtems/score/timestamp.h                   | 2 +-
>  cpukit/include/rtems/score/timestampimpl.h               | 2 +-
>  cpukit/include/rtems/score/wkspace.h                     | 2 +-
>  cpukit/include/rtems/seterr.h                            | 2 +-
>  cpukit/include/rtems/shell.h                             | 2 +-
>  cpukit/include/rtems/shellconfig.h                       | 2 +-
>  cpukit/include/rtems/spurious.h                          | 2 +-
>  cpukit/include/rtems/stackchk.h                          | 2 +-
>  cpukit/include/rtems/stringto.h                          | 2 +-
>  cpukit/include/rtems/termiostypes.h                      | 2 +-
>  cpukit/include/rtems/watchdogdrv.h                       | 2 +-
>  cpukit/include/sys/statvfs.h                             | 2 +-
>  cpukit/libfs/src/dosfs/msdos_statvfs.c                   | 2 +-
>  cpukit/libmisc/capture/capture_buffer.h                  | 2 +-
>  cpukit/libnetworking/rtems/bsdnet/servers.h              | 2 +-
>  cpukit/libnetworking/rtems/mkrootfs.h                    | 2 +-
>  cpukit/libnetworking/rtems/rtems_bsdnet.h                | 2 +-
>  cpukit/rtems/include/rtems/rtems/barriermp.h             | 2 +-
>  cpukit/rtems/src/timerserver.c                           | 2 +-
>  cpukit/score/cpu/epiphany/include/rtems/asm.h            | 2 +-
>  cpukit/score/cpu/epiphany/include/rtems/score/cpu.h      | 2 +-
>  cpukit/score/cpu/epiphany/include/rtems/score/epiphany.h | 2 +-
>  cpukit/score/cpu/m68k/include/rtems/score/cpu.h          | 2 +-
>  cpukit/score/cpu/mips/include/rtems/mips/idtcpu.h        | 2 +-
>  cpukit/score/cpu/mips/include/rtems/mips/iregdef.h       | 2 +-
>  cpukit/score/cpu/mips/include/rtems/score/mips.h         | 2 +-
>  cpukit/score/cpu/moxie/include/rtems/asm.h               | 2 +-
>  cpukit/score/cpu/moxie/include/rtems/score/cpu.h         | 2 +-
>  cpukit/score/cpu/moxie/include/rtems/score/moxie.h       | 2 +-
>  cpukit/score/cpu/no_cpu/include/rtems/asm.h              | 2 +-
>  cpukit/score/cpu/no_cpu/include/rtems/score/cpu.h        | 2 +-
>  cpukit/score/cpu/or1k/include/rtems/asm.h                | 2 +-
>  cpukit/score/cpu/or1k/include/rtems/score/cpu.h          | 2 +-
>  cpukit/score/cpu/or1k/include/rtems/score/or1k.h         | 2 +-
>  cpukit/score/cpu/riscv/include/rtems/asm.h               | 2 +-
>  cpukit/score/cpu/riscv/include/rtems/score/cpu.h         | 2 +-
>  cpukit/score/cpu/riscv/include/rtems/score/riscv.h       | 2 +-
>  cpukit/score/cpu/sh/include/rtems/score/cpu.h            | 2 +-
>  cpukit/score/cpu/x86_64/include/rtems/asm.h              | 2 +-
>  cpukit/score/cpu/x86_64/include/rtems/score/cpu.h        | 2 +-
>  cpukit/score/src/corerwlockobtainread.c                  | 2 +-
>  cpukit/score/src/schedulersimpleunblock.c                | 2 +-
>  cpukit/score/src/timespecsubtract.c                      | 2 +-
>  cpukit/score/src/timespectoticks.c                       | 2 +-
>  216 files changed, 216 insertions(+), 216 deletions(-)
>
> diff --git a/bsps/arm/include/bsp/arm-errata.h
> b/bsps/arm/include/bsp/arm-errata.h
> index 5108c98f15..ae23dd5486 100644
> --- a/bsps/arm/include/bsp/arm-errata.h
> +++ b/bsps/arm/include/bsp/arm-errata.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file arm-errata.h
> + * @file
>   *
>   * @ingroup arm_shared
>   *
> diff --git a/bsps/arm/include/bsp/arm-release-id.h
> b/bsps/arm/include/bsp/arm-release-id.h
> index e06be006da..45d5bd46cc 100644
> --- a/bsps/arm/include/bsp/arm-release-id.h
> +++ b/bsps/arm/include/bsp/arm-release-id.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file arm-release-id.h
> + * @file
>   *
>   * @ingroup arm_shared
>   *
> diff --git a/bsps/arm/include/cmsis_gcc.h b/bsps/arm/include/cmsis_gcc.h
> index d868f2e64b..5c362f4606 100644
> --- a/bsps/arm/include/cmsis_gcc.h
> +++ b/bsps/arm/include/cmsis_gcc.h
> @@ -1,5 +1,5 @@
>
>  /**************************************************************************//**
> - * @file     cmsis_gcc.h
> + * @file
>   * @brief    CMSIS Cortex-M Core Function/Instruction Header File
>   * @version  V4.30
>   * @date     20. October 2015
> diff --git a/bsps/arm/include/core_cm7.h b/bsps/arm/include/core_cm7.h
> index 20963c148c..4cf635c786 100644
> --- a/bsps/arm/include/core_cm7.h
> +++ b/bsps/arm/include/core_cm7.h
> @@ -1,5 +1,5 @@
>
>  /**************************************************************************//**
> - * @file     core_cm7.h
> + * @file
>   * @brief    CMSIS Cortex-M7 Core Peripheral Access Layer Header File
>   * @version  V4.30
>   * @date     20. October 2015
> diff --git a/bsps/arm/include/core_cmFunc.h
> b/bsps/arm/include/core_cmFunc.h
> index ca319a55cb..d4c46661db 100644
> --- a/bsps/arm/include/core_cmFunc.h
> +++ b/bsps/arm/include/core_cmFunc.h
> @@ -1,5 +1,5 @@
>
>  /**************************************************************************//**
> - * @file     core_cmFunc.h
> + * @file
>   * @brief    CMSIS Cortex-M Core Function Access Header File
>   * @version  V4.30
>   * @date     20. October 2015
> diff --git a/bsps/arm/include/core_cmInstr.h
> b/bsps/arm/include/core_cmInstr.h
> index a0a506458d..7e88e6c0a4 100644
> --- a/bsps/arm/include/core_cmInstr.h
> +++ b/bsps/arm/include/core_cmInstr.h
> @@ -1,5 +1,5 @@
>
>  /**************************************************************************//**
> - * @file     core_cmInstr.h
> + * @file
>   * @brief    CMSIS Cortex-M Core Instruction Access Header File
>   * @version  V4.30
>   * @date     20. October 2015
> diff --git a/bsps/arm/include/core_cmSimd.h
> b/bsps/arm/include/core_cmSimd.h
> index 4d76bf9018..bef78ab000 100644
> --- a/bsps/arm/include/core_cmSimd.h
> +++ b/bsps/arm/include/core_cmSimd.h
> @@ -1,5 +1,5 @@
>
>  /**************************************************************************//**
> - * @file     core_cmSimd.h
> + * @file
>   * @brief    CMSIS Cortex-M SIMD Header File
>   * @version  V4.30
>   * @date     20. October 2015
> diff --git a/bsps/arm/lpc176x/btimer/btimer.c
> b/bsps/arm/lpc176x/btimer/btimer.c
> index 359d89086d..d2dcfbb1b2 100644
> --- a/bsps/arm/lpc176x/btimer/btimer.c
> +++ b/bsps/arm/lpc176x/btimer/btimer.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file timerbenchmark.c
> + * @file
>   *
>   * @ingroup lpc176x
>   *
> diff --git a/bsps/arm/lpc176x/can/can.c b/bsps/arm/lpc176x/can/can.c
> index e5ffc29b7a..bf94d9fc37 100644
> --- a/bsps/arm/lpc176x/can/can.c
> +++ b/bsps/arm/lpc176x/can/can.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file can.c
> + * @file
>   *
>   * @ingroup lpc176x
>   *
> diff --git a/bsps/arm/lpc176x/gpio/lpc-gpio.c
> b/bsps/arm/lpc176x/gpio/lpc-gpio.c
> index e7f07fe657..220f5f9abc 100644
> --- a/bsps/arm/lpc176x/gpio/lpc-gpio.c
> +++ b/bsps/arm/lpc176x/gpio/lpc-gpio.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file lpc-gpio.c
> + * @file
>   *
>   * @ingroup lpc176x
>   *
> diff --git a/bsps/arm/lpc176x/include/bsp/adc-defs.h
> b/bsps/arm/lpc176x/include/bsp/adc-defs.h
> index 3daca807b7..e1a4825a2a 100644
> --- a/bsps/arm/lpc176x/include/bsp/adc-defs.h
> +++ b/bsps/arm/lpc176x/include/bsp/adc-defs.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file adc-defs.h
> + * @file
>   *
>   * @ingroup lpc176x
>   *
> diff --git a/bsps/arm/lpc176x/include/bsp/adc.h
> b/bsps/arm/lpc176x/include/bsp/adc.h
> index 34df8b7efd..58c6de3f1d 100644
> --- a/bsps/arm/lpc176x/include/bsp/adc.h
> +++ b/bsps/arm/lpc176x/include/bsp/adc.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file adc.h
> + * @file
>   *
>   * @ingroup lpc176x
>   *
> diff --git a/bsps/arm/lpc176x/include/bsp/can-defs.h
> b/bsps/arm/lpc176x/include/bsp/can-defs.h
> index 4db229eb1c..b55414f95f 100644
> --- a/bsps/arm/lpc176x/include/bsp/can-defs.h
> +++ b/bsps/arm/lpc176x/include/bsp/can-defs.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file can-defs.h
> + * @file
>   *
>   * @ingroup lpc176x
>   *
> diff --git a/bsps/arm/lpc176x/include/bsp/can.h
> b/bsps/arm/lpc176x/include/bsp/can.h
> index 7515ec2f53..27fabc40e6 100644
> --- a/bsps/arm/lpc176x/include/bsp/can.h
> +++ b/bsps/arm/lpc176x/include/bsp/can.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file can.h
> + * @file
>   *
>   * @ingroup lpc176x
>   *
> diff --git a/bsps/arm/lpc176x/include/bsp/common-types.h
> b/bsps/arm/lpc176x/include/bsp/common-types.h
> index 943ff288a9..16bfd96f3a 100644
> --- a/bsps/arm/lpc176x/include/bsp/common-types.h
> +++ b/bsps/arm/lpc176x/include/bsp/common-types.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file common-types.h
> + * @file
>   *
>   * @ingroup lpc176x
>   *
> diff --git a/bsps/arm/lpc176x/include/bsp/gpio-defs.h
> b/bsps/arm/lpc176x/include/bsp/gpio-defs.h
> index c6ed499d35..31155bf597 100644
> --- a/bsps/arm/lpc176x/include/bsp/gpio-defs.h
> +++ b/bsps/arm/lpc176x/include/bsp/gpio-defs.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file gpio-defs.h
> + * @file
>   *
>   * @ingroup lpc176x
>   *
> diff --git a/bsps/arm/lpc176x/include/bsp/io-defs.h
> b/bsps/arm/lpc176x/include/bsp/io-defs.h
> index f9cf3dbbbd..de57aadd8c 100644
> --- a/bsps/arm/lpc176x/include/bsp/io-defs.h
> +++ b/bsps/arm/lpc176x/include/bsp/io-defs.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file io-defs.h
> + * @file
>   *
>   * @ingroup lpc176x
>   *
> diff --git a/bsps/arm/lpc176x/include/bsp/io.h
> b/bsps/arm/lpc176x/include/bsp/io.h
> index 4a8510479c..3e6cd49581 100644
> --- a/bsps/arm/lpc176x/include/bsp/io.h
> +++ b/bsps/arm/lpc176x/include/bsp/io.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file io.h
> + * @file
>   *
>   * @ingroup lpc176x
>   *
> diff --git a/bsps/arm/lpc176x/include/bsp/lpc-gpio.h
> b/bsps/arm/lpc176x/include/bsp/lpc-gpio.h
> index 9cb23df142..cc75385a04 100644
> --- a/bsps/arm/lpc176x/include/bsp/lpc-gpio.h
> +++ b/bsps/arm/lpc176x/include/bsp/lpc-gpio.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file lpc-gpio.h
> + * @file
>   *
>   * @ingroup lpc176x
>   *
> diff --git a/bsps/arm/lpc176x/include/bsp/lpc176x.h
> b/bsps/arm/lpc176x/include/bsp/lpc176x.h
> index f10991f346..2f20c2e8ba 100644
> --- a/bsps/arm/lpc176x/include/bsp/lpc176x.h
> +++ b/bsps/arm/lpc176x/include/bsp/lpc176x.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file lpc176x.h
> + * @file
>   *
>   * @ingroup lpc176x
>   *
> diff --git a/bsps/arm/lpc176x/include/bsp/mbed-pinmap.h
> b/bsps/arm/lpc176x/include/bsp/mbed-pinmap.h
> index 3556bc5fbf..538d33c41e 100644
> --- a/bsps/arm/lpc176x/include/bsp/mbed-pinmap.h
> +++ b/bsps/arm/lpc176x/include/bsp/mbed-pinmap.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file mbed-pinmap.h
> + * @file
>   *
>   * @ingroup lpc176x
>   *
> diff --git a/bsps/arm/lpc176x/include/bsp/pwmout-defs.h
> b/bsps/arm/lpc176x/include/bsp/pwmout-defs.h
> index f55b154a05..7b3999d2a6 100644
> --- a/bsps/arm/lpc176x/include/bsp/pwmout-defs.h
> +++ b/bsps/arm/lpc176x/include/bsp/pwmout-defs.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file pwmout-defs.h
> + * @file
>   *
>   * @ingroup lpc176x
>   *
> diff --git a/bsps/arm/lpc176x/include/bsp/pwmout.h
> b/bsps/arm/lpc176x/include/bsp/pwmout.h
> index 1427fc5f3e..bbed297ae9 100644
> --- a/bsps/arm/lpc176x/include/bsp/pwmout.h
> +++ b/bsps/arm/lpc176x/include/bsp/pwmout.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file pwmout.h
> + * @file
>   *
>   * @ingroup lpc176x
>   *
> diff --git a/bsps/arm/lpc176x/include/bsp/timer-defs.h
> b/bsps/arm/lpc176x/include/bsp/timer-defs.h
> index 3827aa9279..7560add64e 100644
> --- a/bsps/arm/lpc176x/include/bsp/timer-defs.h
> +++ b/bsps/arm/lpc176x/include/bsp/timer-defs.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file timer-defs.h
> + * @file
>   *
>   * @ingroup lpc176x
>   *
> diff --git a/bsps/arm/lpc176x/include/bsp/timer.h
> b/bsps/arm/lpc176x/include/bsp/timer.h
> index 6805b55f0e..bb327eefce 100644
> --- a/bsps/arm/lpc176x/include/bsp/timer.h
> +++ b/bsps/arm/lpc176x/include/bsp/timer.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file timer.h
> + * @file
>   *
>   * @ingroup lpc176x
>   *
> diff --git a/bsps/arm/lpc176x/include/bsp/watchdog-defs.h
> b/bsps/arm/lpc176x/include/bsp/watchdog-defs.h
> index 44ea80527e..888ebe1936 100644
> --- a/bsps/arm/lpc176x/include/bsp/watchdog-defs.h
> +++ b/bsps/arm/lpc176x/include/bsp/watchdog-defs.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file watchdog-defs.h
> + * @file
>   *
>   * @ingroup lpc176x
>   *
> diff --git a/bsps/arm/lpc176x/include/bsp/watchdog.h
> b/bsps/arm/lpc176x/include/bsp/watchdog.h
> index 8b5f033605..ff5d1730fa 100644
> --- a/bsps/arm/lpc176x/include/bsp/watchdog.h
> +++ b/bsps/arm/lpc176x/include/bsp/watchdog.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file watchdog.h
> + * @file
>   *
>   * @ingroup lpc176x
>   *
> diff --git a/bsps/arm/lpc176x/pwm/pwmout.c b/bsps/arm/lpc176x/pwm/pwmout.c
> index dc30475f89..c5ce3eb998 100644
> --- a/bsps/arm/lpc176x/pwm/pwmout.c
> +++ b/bsps/arm/lpc176x/pwm/pwmout.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file pwmout.c
> + * @file
>   *
>   * @ingroup lpc176x
>   *
> diff --git a/bsps/arm/lpc176x/start/adc.c b/bsps/arm/lpc176x/start/adc.c
> index 7098166718..49288c07c6 100644
> --- a/bsps/arm/lpc176x/start/adc.c
> +++ b/bsps/arm/lpc176x/start/adc.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file adc.c
> + * @file
>   *
>   * @ingroup lpc176x
>   *
> diff --git a/bsps/arm/lpc176x/start/bspstarthooks.c
> b/bsps/arm/lpc176x/start/bspstarthooks.c
> index a60c5bdf89..dc790f3eb0 100644
> --- a/bsps/arm/lpc176x/start/bspstarthooks.c
> +++ b/bsps/arm/lpc176x/start/bspstarthooks.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file bspstarthooks.c
> + * @file
>   *
>   * @ingroup lpc176x
>   *
> diff --git a/bsps/arm/lpc176x/start/io.c b/bsps/arm/lpc176x/start/io.c
> index c25fe94c0b..8eb746cbad 100644
> --- a/bsps/arm/lpc176x/start/io.c
> +++ b/bsps/arm/lpc176x/start/io.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file io.c
> + * @file
>   *
>   * @ingroup lpc176x
>   *
> diff --git a/bsps/arm/lpc176x/start/watchdog.c
> b/bsps/arm/lpc176x/start/watchdog.c
> index bae9b4e1b1..4b8b23d9f0 100644
> --- a/bsps/arm/lpc176x/start/watchdog.c
> +++ b/bsps/arm/lpc176x/start/watchdog.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file watchdog.c
> + * @file
>   *
>   * @ingroup lpc176x
>   *
> diff --git a/bsps/arm/lpc176x/timer/timer.c
> b/bsps/arm/lpc176x/timer/timer.c
> index 36c720b4fb..47992fcd96 100644
> --- a/bsps/arm/lpc176x/timer/timer.c
> +++ b/bsps/arm/lpc176x/timer/timer.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file timer.c
> + * @file
>   *
>   * @ingroup lpc176x
>   *
> diff --git a/bsps/arm/lpc32xx/include/tm27.h
> b/bsps/arm/lpc32xx/include/tm27.h
> index 4cbc17a085..a7cc2dd802 100644
> --- a/bsps/arm/lpc32xx/include/tm27.h
> +++ b/bsps/arm/lpc32xx/include/tm27.h
> @@ -1,4 +1,4 @@
> -/* @file
> +/* @file
>   *
>   * @ingroup arm_lpc32xx
>   *
> diff --git a/bsps/arm/raspberrypi/gpio/gpio-interfaces-pi1-rev2.c
> b/bsps/arm/raspberrypi/gpio/gpio-interfaces-pi1-rev2.c
> index a958e0dc8e..1a89bf7c12 100644
> --- a/bsps/arm/raspberrypi/gpio/gpio-interfaces-pi1-rev2.c
> +++ b/bsps/arm/raspberrypi/gpio/gpio-interfaces-pi1-rev2.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file gpio-interfaces-pi1-rev2.c
> + * @file
>   *
>   * @ingroup raspberrypi_gpio
>   *
> diff --git a/bsps/arm/raspberrypi/gpio/rpi-gpio.c
> b/bsps/arm/raspberrypi/gpio/rpi-gpio.c
> index 6c01d62404..52be89a9ea 100644
> --- a/bsps/arm/raspberrypi/gpio/rpi-gpio.c
> +++ b/bsps/arm/raspberrypi/gpio/rpi-gpio.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file rpi-gpio.c
> + * @file
>   *
>   * @ingroup raspberrypi_gpio
>   *
> diff --git a/bsps/arm/raspberrypi/i2c/i2c.c
> b/bsps/arm/raspberrypi/i2c/i2c.c
> index d3912671cd..7995c55d1e 100644
> --- a/bsps/arm/raspberrypi/i2c/i2c.c
> +++ b/bsps/arm/raspberrypi/i2c/i2c.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file i2c.c
> + * @file
>   *
>   * @ingroup raspberrypi_i2c
>   *
> diff --git a/bsps/arm/raspberrypi/include/bsp/i2c.h
> b/bsps/arm/raspberrypi/include/bsp/i2c.h
> index 4a8dbbf2ac..c265720fc5 100644
> --- a/bsps/arm/raspberrypi/include/bsp/i2c.h
> +++ b/bsps/arm/raspberrypi/include/bsp/i2c.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file i2c.h
> + * @file
>   *
>   * @ingroup raspberrypi_i2c
>   *
> diff --git a/bsps/arm/raspberrypi/include/bsp/raspberrypi.h
> b/bsps/arm/raspberrypi/include/bsp/raspberrypi.h
> index 4ef5f713ad..6f4c8e3de5 100644
> --- a/bsps/arm/raspberrypi/include/bsp/raspberrypi.h
> +++ b/bsps/arm/raspberrypi/include/bsp/raspberrypi.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file raspberrypi.h
> + * @file
>   *
>   * @ingroup raspberrypi_reg
>   *
> diff --git a/bsps/arm/raspberrypi/include/bsp/rpi-gpio.h
> b/bsps/arm/raspberrypi/include/bsp/rpi-gpio.h
> index 82ba4b1f2a..ae558042e3 100644
> --- a/bsps/arm/raspberrypi/include/bsp/rpi-gpio.h
> +++ b/bsps/arm/raspberrypi/include/bsp/rpi-gpio.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rpi-gpio.h
> + * @file
>   *
>   * @ingroup raspberrypi_gpio
>   *
> diff --git a/bsps/arm/raspberrypi/include/bsp/spi.h
> b/bsps/arm/raspberrypi/include/bsp/spi.h
> index 1bbbc6d2a4..a7019c7fd0 100644
> --- a/bsps/arm/raspberrypi/include/bsp/spi.h
> +++ b/bsps/arm/raspberrypi/include/bsp/spi.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file spi.h
> + * @file
>   *
>   * @ingroup raspberrypi_spi
>   *
> diff --git a/bsps/arm/raspberrypi/irq/irq.c
> b/bsps/arm/raspberrypi/irq/irq.c
> index 925596ae51..9e1bcfc1bc 100644
> --- a/bsps/arm/raspberrypi/irq/irq.c
> +++ b/bsps/arm/raspberrypi/irq/irq.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file irq.c
> + * @file
>   *
>   * @ingroup raspberrypi_interrupt
>   *
> diff --git a/bsps/arm/raspberrypi/spi/spi.c
> b/bsps/arm/raspberrypi/spi/spi.c
> index ae77f6272d..36db3d8db5 100644
> --- a/bsps/arm/raspberrypi/spi/spi.c
> +++ b/bsps/arm/raspberrypi/spi/spi.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file spi.c
> + * @file
>   *
>   * @ingroup raspberrypi_spi
>   *
> diff --git a/bsps/arm/shared/start/bsp-start-init-registers.S
> b/bsps/arm/shared/start/bsp-start-init-registers.S
> index 2e308ce5de..961d3172bf 100644
> --- a/bsps/arm/shared/start/bsp-start-init-registers.S
> +++ b/bsps/arm/shared/start/bsp-start-init-registers.S
> @@ -1,5 +1,5 @@
>  /**
> - * @file bsp-start-init-registers.S
> + * @file
>   *
>   * @brief ARM register initialization routines.
>   */
> diff --git a/bsps/arm/tms570/clock/clock.c b/bsps/arm/tms570/clock/clock.c
> index 8290504396..c87b7e2043 100644
> --- a/bsps/arm/tms570/clock/clock.c
> +++ b/bsps/arm/tms570/clock/clock.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file clock.c
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/console/printk-support.c
> b/bsps/arm/tms570/console/printk-support.c
> index 529c5dba20..8785db32c8 100644
> --- a/bsps/arm/tms570/console/printk-support.c
> +++ b/bsps/arm/tms570/console/printk-support.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file printk-support.c
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/console/tms570-sci.c
> b/bsps/arm/tms570/console/tms570-sci.c
> index 9f16c42428..53986dece0 100644
> --- a/bsps/arm/tms570/console/tms570-sci.c
> +++ b/bsps/arm/tms570/console/tms570-sci.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file tms570-sci.c
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/include/bsp.h b/bsps/arm/tms570/include/bsp.h
> index 456380627f..f557d868ee 100644
> --- a/bsps/arm/tms570/include/bsp.h
> +++ b/bsps/arm/tms570/include/bsp.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file bsp.h
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/include/bsp/irq.h
> b/bsps/arm/tms570/include/bsp/irq.h
> index 2952582453..c90c6002c1 100644
> --- a/bsps/arm/tms570/include/bsp/irq.h
> +++ b/bsps/arm/tms570/include/bsp/irq.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file irq.h
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/include/bsp/system-clocks.h
> b/bsps/arm/tms570/include/bsp/system-clocks.h
> index 0e1d1301d4..ea60b3a6a5 100644
> --- a/bsps/arm/tms570/include/bsp/system-clocks.h
> +++ b/bsps/arm/tms570/include/bsp/system-clocks.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file benchmark_timer.c
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/include/bsp/tms570-pinmux.h
> b/bsps/arm/tms570/include/bsp/tms570-pinmux.h
> index 8b93c66bfa..edf23f27f3 100644
> --- a/bsps/arm/tms570/include/bsp/tms570-pinmux.h
> +++ b/bsps/arm/tms570/include/bsp/tms570-pinmux.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file tms570-pinmux.h
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/include/bsp/tms570-pins.h
> b/bsps/arm/tms570/include/bsp/tms570-pins.h
> index f8db69fa19..ac9cf4ca74 100644
> --- a/bsps/arm/tms570/include/bsp/tms570-pins.h
> +++ b/bsps/arm/tms570/include/bsp/tms570-pins.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file tms570-pins.h
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/include/bsp/tms570-pom.h
> b/bsps/arm/tms570/include/bsp/tms570-pom.h
> index 2c54a016dc..db8a54b824 100644
> --- a/bsps/arm/tms570/include/bsp/tms570-pom.h
> +++ b/bsps/arm/tms570/include/bsp/tms570-pom.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file tms570-pom.h
> + * @file
>   * @ingroup tms570
>   * @brief Parameter Overlay Module (POM) header file
>   */
> diff --git a/bsps/arm/tms570/include/bsp/tms570-rti.h
> b/bsps/arm/tms570/include/bsp/tms570-rti.h
> index 552db88a62..deb360af3a 100644
> --- a/bsps/arm/tms570/include/bsp/tms570-rti.h
> +++ b/bsps/arm/tms570/include/bsp/tms570-rti.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file tms570-rti.h
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/include/bsp/tms570-sci-driver.h
> b/bsps/arm/tms570/include/bsp/tms570-sci-driver.h
> index 61693ce0ff..2cb63d687c 100644
> --- a/bsps/arm/tms570/include/bsp/tms570-sci-driver.h
> +++ b/bsps/arm/tms570/include/bsp/tms570-sci-driver.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file tms570-sci-driver.h
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/include/bsp/tms570-sci.h
> b/bsps/arm/tms570/include/bsp/tms570-sci.h
> index 9c502dcd6a..c2ef198de6 100644
> --- a/bsps/arm/tms570/include/bsp/tms570-sci.h
> +++ b/bsps/arm/tms570/include/bsp/tms570-sci.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file tms570-sci.h
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/include/bsp/tms570-vim.h
> b/bsps/arm/tms570/include/bsp/tms570-vim.h
> index 9fa7e056f4..27173be098 100644
> --- a/bsps/arm/tms570/include/bsp/tms570-vim.h
> +++ b/bsps/arm/tms570/include/bsp/tms570-vim.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file tms570-vim.h
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/include/bsp/tms570_selftest.h
> b/bsps/arm/tms570/include/bsp/tms570_selftest.h
> index bbec8c2adf..d3fb6f8dbe 100644
> --- a/bsps/arm/tms570/include/bsp/tms570_selftest.h
> +++ b/bsps/arm/tms570/include/bsp/tms570_selftest.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file tms570_selftest.h
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/include/bsp/tms570_selftest_parity.h
> b/bsps/arm/tms570/include/bsp/tms570_selftest_parity.h
> index a1c3ec7b3e..287d964969 100644
> --- a/bsps/arm/tms570/include/bsp/tms570_selftest_parity.h
> +++ b/bsps/arm/tms570/include/bsp/tms570_selftest_parity.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file tms570_selftest_parity.h
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/include/bsp/tms570lc4357-pins.h
> b/bsps/arm/tms570/include/bsp/tms570lc4357-pins.h
> index 2beeae8bab..125a7792e0 100644
> --- a/bsps/arm/tms570/include/bsp/tms570lc4357-pins.h
> +++ b/bsps/arm/tms570/include/bsp/tms570lc4357-pins.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file tms570lc4357-pins.h
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/include/bsp/tms570ls3137zwt-pins.h
> b/bsps/arm/tms570/include/bsp/tms570ls3137zwt-pins.h
> index 63c08e8ddb..f906636232 100644
> --- a/bsps/arm/tms570/include/bsp/tms570ls3137zwt-pins.h
> +++ b/bsps/arm/tms570/include/bsp/tms570ls3137zwt-pins.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file tms570ls3137zwt-pins.h
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/irq/irq.c b/bsps/arm/tms570/irq/irq.c
> index 579c11ed2a..877b6e2985 100644
> --- a/bsps/arm/tms570/irq/irq.c
> +++ b/bsps/arm/tms570/irq/irq.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file irq.c
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/start/bspreset.c
> b/bsps/arm/tms570/start/bspreset.c
> index f6bdee27e1..beac0f0f16 100644
> --- a/bsps/arm/tms570/start/bspreset.c
> +++ b/bsps/arm/tms570/start/bspreset.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file bspreset.c
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/start/bspstart.c
> b/bsps/arm/tms570/start/bspstart.c
> index 025bb741d2..abf9eff392 100644
> --- a/bsps/arm/tms570/start/bspstart.c
> +++ b/bsps/arm/tms570/start/bspstart.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file bspstart.c
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/start/bspstarthooks.c
> b/bsps/arm/tms570/start/bspstarthooks.c
> index a9e189b6b8..64e57d6d13 100644
> --- a/bsps/arm/tms570/start/bspstarthooks.c
> +++ b/bsps/arm/tms570/start/bspstarthooks.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file bspstarthooks.c
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/start/init_emif_sdram.c
> b/bsps/arm/tms570/start/init_emif_sdram.c
> index 6ce0ccb363..3004e03b11 100644
> --- a/bsps/arm/tms570/start/init_emif_sdram.c
> +++ b/bsps/arm/tms570/start/init_emif_sdram.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file init_emif_sdram.c
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/start/init_esm.c
> b/bsps/arm/tms570/start/init_esm.c
> index 63bd756c0d..9364cba384 100644
> --- a/bsps/arm/tms570/start/init_esm.c
> +++ b/bsps/arm/tms570/start/init_esm.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file init_esm.c
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/start/init_pinmux.c
> b/bsps/arm/tms570/start/init_pinmux.c
> index 8585d665b3..f294dd8ad2 100644
> --- a/bsps/arm/tms570/start/init_pinmux.c
> +++ b/bsps/arm/tms570/start/init_pinmux.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file init_pinmux.c
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/start/init_system.c
> b/bsps/arm/tms570/start/init_system.c
> index 7611d83af7..690ee9ba1c 100644
> --- a/bsps/arm/tms570/start/init_system.c
> +++ b/bsps/arm/tms570/start/init_system.c
> @@ -1,4 +1,4 @@
> -/** @file init_system.c
> +/** @file
>
>     based on Ti HalCoGen generated file
>   */
> diff --git a/bsps/arm/tms570/start/pinmux.c
> b/bsps/arm/tms570/start/pinmux.c
> index 11e557910b..44f5468146 100644
> --- a/bsps/arm/tms570/start/pinmux.c
> +++ b/bsps/arm/tms570/start/pinmux.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file pinmux.c
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/start/tms570-pom.c
> b/bsps/arm/tms570/start/tms570-pom.c
> index 4fdc3e89eb..d884ef8aa3 100644
> --- a/bsps/arm/tms570/start/tms570-pom.c
> +++ b/bsps/arm/tms570/start/tms570-pom.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file tms570-pom.c
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/start/tms570_selftest.c
> b/bsps/arm/tms570/start/tms570_selftest.c
> index c33f6acc83..5861b4e898 100644
> --- a/bsps/arm/tms570/start/tms570_selftest.c
> +++ b/bsps/arm/tms570/start/tms570_selftest.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file tms570_selftest.c
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/start/tms570_selftest_par_can.c
> b/bsps/arm/tms570/start/tms570_selftest_par_can.c
> index 5cafd66374..d96baf6961 100644
> --- a/bsps/arm/tms570/start/tms570_selftest_par_can.c
> +++ b/bsps/arm/tms570/start/tms570_selftest_par_can.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file tms570_selftest_par_can.c
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/start/tms570_selftest_par_mibspi.c
> b/bsps/arm/tms570/start/tms570_selftest_par_mibspi.c
> index 3b9724d6a4..51889309d9 100644
> --- a/bsps/arm/tms570/start/tms570_selftest_par_mibspi.c
> +++ b/bsps/arm/tms570/start/tms570_selftest_par_mibspi.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file tms570_selftest_par_can.c
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/start/tms570_selftest_par_std.c
> b/bsps/arm/tms570/start/tms570_selftest_par_std.c
> index 53dff31b85..7ad64407db 100644
> --- a/bsps/arm/tms570/start/tms570_selftest_par_std.c
> +++ b/bsps/arm/tms570/start/tms570_selftest_par_std.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file tms570_selftest_par_std.c
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/start/tms570_selftest_parity.c
> b/bsps/arm/tms570/start/tms570_selftest_parity.c
> index 2ee3bea00d..a7d32a39f0 100644
> --- a/bsps/arm/tms570/start/tms570_selftest_parity.c
> +++ b/bsps/arm/tms570/start/tms570_selftest_parity.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file tms570_selftest_parity.c
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/arm/tms570/start/tms570_tcram_tests.c
> b/bsps/arm/tms570/start/tms570_tcram_tests.c
> index ce5dd68f34..dfee9d8e52 100644
> --- a/bsps/arm/tms570/start/tms570_tcram_tests.c
> +++ b/bsps/arm/tms570/start/tms570_tcram_tests.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file tms570_tcram_tests.c
> + * @file
>   *
>   * @ingroup tms570
>   *
> diff --git a/bsps/bfin/TLL6527M/console/console.c
> b/bsps/bfin/TLL6527M/console/console.c
> index 1871bdbb9d..b7de975220 100644
> --- a/bsps/bfin/TLL6527M/console/console.c
> +++ b/bsps/bfin/TLL6527M/console/console.c
> @@ -1,5 +1,5 @@
>  /**
> - *@file console.c
> + *@file
>   *
>   *@brief
>   *  - This file implements uart console for TLL6527M. TLL6527M has BF527
> with
> diff --git a/bsps/bfin/TLL6527M/include/bsp.h
> b/bsps/bfin/TLL6527M/include/bsp.h
> index 04ffb1c293..96321f8ece 100644
> --- a/bsps/bfin/TLL6527M/include/bsp.h
> +++ b/bsps/bfin/TLL6527M/include/bsp.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file bsp.h
> + * @file
>   * @ingroup bfin_tll6527m
>   * @brief Global BSP definitions.
>   *
> diff --git a/bsps/bfin/TLL6527M/start/interrupt.c
> b/bsps/bfin/TLL6527M/start/interrupt.c
> index 1b69046453..aa3f2c61ca 100644
> --- a/bsps/bfin/TLL6527M/start/interrupt.c
> +++ b/bsps/bfin/TLL6527M/start/interrupt.c
> @@ -1,5 +1,5 @@
>  /**
> - *@file interrupt.c
> + *@file
>   *
>   *@brief
>   * - This file implements interrupt dispatcher. Most of the code is taken
> from
> diff --git a/bsps/bfin/include/bf52x.h b/bsps/bfin/include/bf52x.h
> index 6c3d087c79..11d0ef15a3 100644
> --- a/bsps/bfin/include/bf52x.h
> +++ b/bsps/bfin/include/bf52x.h
> @@ -1,5 +1,5 @@
>  /**
> - *@file bf52x.h
> + *@file
>   *
>   *@brief
>   *  - This file provides the register address for the 52X model. The file
> is
> diff --git a/bsps/bfin/include/bsp/interrupt.h
> b/bsps/bfin/include/bsp/interrupt.h
> index 7a98775dd5..2822899918 100644
> --- a/bsps/bfin/include/bsp/interrupt.h
> +++ b/bsps/bfin/include/bsp/interrupt.h
> @@ -1,5 +1,5 @@
>  /**
> - *@file interrupt.h
> + *@file
>   *
>   *@brief
>   *  - This file implements interrupt dispatcher. The init code is taken
> from
> diff --git a/bsps/i386/include/bsp/realmode_int.h
> b/bsps/i386/include/bsp/realmode_int.h
> index e8a1e36d01..6d246e3c91 100644
> --- a/bsps/i386/include/bsp/realmode_int.h
> +++ b/bsps/i386/include/bsp/realmode_int.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file realmode_int.h
> + * @file
>   *
>   * @ingroup i386_shared
>   *
> diff --git a/bsps/i386/include/libcpu/page.h
> b/bsps/i386/include/libcpu/page.h
> index 5e9cec2227..0da4a54634 100644
> --- a/bsps/i386/include/libcpu/page.h
> +++ b/bsps/i386/include/libcpu/page.h
> @@ -1,5 +1,5 @@
>  /*
> - * @file page.h
> + * @file
>   *
>   * Copyright (C) 1998  Eric Valette (valette at crf.canon.fr)
>   *                     Canon Centre Recherche France.
> diff --git a/bsps/i386/pc386/console/fb_vesa_rm.c
> b/bsps/i386/pc386/console/fb_vesa_rm.c
> index 1c42956fce..857f5b8d1d 100644
> --- a/bsps/i386/pc386/console/fb_vesa_rm.c
> +++ b/bsps/i386/pc386/console/fb_vesa_rm.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file fb_vesa_rm.c
> + * @file
>   *
>   * @ingroup i386_pc386
>   *
> diff --git a/bsps/i386/pc386/include/bsp/fb_default_mode.h
> b/bsps/i386/pc386/include/bsp/fb_default_mode.h
> index 948ffee5b6..a71e379ce5 100644
> --- a/bsps/i386/pc386/include/bsp/fb_default_mode.h
> +++ b/bsps/i386/pc386/include/bsp/fb_default_mode.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file fb_default_mode.h
> + * @file
>   *
>   * @ingroup i386_pc386
>   *
> diff --git a/bsps/i386/pc386/include/bsp/fb_vesa.h
> b/bsps/i386/pc386/include/bsp/fb_vesa.h
> index d8bfd1bcb4..ecb56d7b0f 100644
> --- a/bsps/i386/pc386/include/bsp/fb_vesa.h
> +++ b/bsps/i386/pc386/include/bsp/fb_vesa.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file fb_vesa.h
> + * @file
>   *
>   * @ingroup i386_pc386
>   *
> diff --git a/bsps/i386/pc386/include/bsp/vbe3.h
> b/bsps/i386/pc386/include/bsp/vbe3.h
> index b62ab6f3ac..4d1bf51661 100644
> --- a/bsps/i386/pc386/include/bsp/vbe3.h
> +++ b/bsps/i386/pc386/include/bsp/vbe3.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file vbe3.h
> + * @file
>   *
>   * @ingroup i386_pc386
>   *
> diff --git a/bsps/i386/pc386/include/edid.h
> b/bsps/i386/pc386/include/edid.h
> index 1653087e7e..48beb10f1c 100644
> --- a/bsps/i386/pc386/include/edid.h
> +++ b/bsps/i386/pc386/include/edid.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file edid.h
> + * @file
>   *
>   * @ingroup i386_pc386
>   *
> diff --git a/bsps/i386/pc386/start/realmode_int.c
> b/bsps/i386/pc386/start/realmode_int.c
> index 58c39c8c24..bbabe189c6 100644
> --- a/bsps/i386/pc386/start/realmode_int.c
> +++ b/bsps/i386/pc386/start/realmode_int.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file realmode_int.c
> + * @file
>   *
>   * @ingroup i386_shared
>   *
> diff --git a/bsps/include/bsp/gpio.h b/bsps/include/bsp/gpio.h
> index 64a877ae7a..23eb729169 100644
> --- a/bsps/include/bsp/gpio.h
> +++ b/bsps/include/bsp/gpio.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file gpio.h
> + * @file
>   *
>   * @ingroup rtems_gpio
>   *
> diff --git a/bsps/powerpc/include/rtems/powerpc/powerpc.h
> b/bsps/powerpc/include/rtems/powerpc/powerpc.h
> index f1b6e80db2..4e16dd0be8 100644
> --- a/bsps/powerpc/include/rtems/powerpc/powerpc.h
> +++ b/bsps/powerpc/include/rtems/powerpc/powerpc.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/powerpc/powerpc.h
> + * @file
>   */
>
>  /*
> diff --git a/bsps/powerpc/virtex4/start/start.S
> b/bsps/powerpc/virtex4/start/start.S
> index 5189ec5af6..645adf2fe7 100644
> --- a/bsps/powerpc/virtex4/start/start.S
> +++ b/bsps/powerpc/virtex4/start/start.S
> @@ -1,4 +1,4 @@
> -/*!@file      start.S
> +/*!@file
>  *
>  *  @brief     Initialization code to set up the CPU and call boot_card()
>  *
> diff --git a/bsps/powerpc/virtex5/start/start.S
> b/bsps/powerpc/virtex5/start/start.S
> index c17587fbce..fa6c7154a3 100644
> --- a/bsps/powerpc/virtex5/start/start.S
> +++ b/bsps/powerpc/virtex5/start/start.S
> @@ -1,4 +1,4 @@
> -/*!@file      start.S
> +/*!@file
>  *
>  *  @brief     Initialization code to set up the CPU and call boot_card()
>  *
> diff --git a/bsps/shared/dev/gpio/gpio-support.c
> b/bsps/shared/dev/gpio/gpio-support.c
> index 9ceeb4070f..9c053dc151 100644
> --- a/bsps/shared/dev/gpio/gpio-support.c
> +++ b/bsps/shared/dev/gpio/gpio-support.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file gpio.c
> + * @file
>   *
>   * @ingroup rtems_gpio
>   *
> diff --git a/cpukit/include/memory.h b/cpukit/include/memory.h
> index 99fdb5e1e4..d802bb58e3 100644
> --- a/cpukit/include/memory.h
> +++ b/cpukit/include/memory.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file memory.h
> + * @file
>   *
>   * Dummy include file for FreeBSD routines
>   */
> diff --git a/cpukit/include/rtems/assoc.h b/cpukit/include/rtems/assoc.h
> index 345761758a..97e50013d7 100644
> --- a/cpukit/include/rtems/assoc.h
> +++ b/cpukit/include/rtems/assoc.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/assoc.h
> + * @file
>   *
>   * @brief RTEMS Associativity Routines
>   *
> diff --git a/cpukit/include/rtems/bspIo.h b/cpukit/include/rtems/bspIo.h
> index d49fe3a228..61eb873188 100644
> --- a/cpukit/include/rtems/bspIo.h
> +++ b/cpukit/include/rtems/bspIo.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/bspIo.h
> + * @file
>   *
>   * @brief Interface to Kernel Print Methods
>   *
> diff --git a/cpukit/include/rtems/bspcmdline.h
> b/cpukit/include/rtems/bspcmdline.h
> index 51916ff26a..058363295b 100644
> --- a/cpukit/include/rtems/bspcmdline.h
> +++ b/cpukit/include/rtems/bspcmdline.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/bspcmdline.h
> + * @file
>   *
>   * @defgroup BSPCommandLine BSP Command Line Helpers
>   *
> diff --git a/cpukit/include/rtems/btimer.h b/cpukit/include/rtems/btimer.h
> index 78f8d9c185..ad9c629eba 100644
> --- a/cpukit/include/rtems/btimer.h
> +++ b/cpukit/include/rtems/btimer.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/btimer.h
> + * @file
>   *
>   * @brief RTEMS Benchmark Timer API for all Boards
>   */
> diff --git a/cpukit/include/rtems/capture-cli.h
> b/cpukit/include/rtems/capture-cli.h
> index 55749b7cb1..879a600665 100644
> --- a/cpukit/include/rtems/capture-cli.h
> +++ b/cpukit/include/rtems/capture-cli.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/capture-cli.h
> + * @file
>   *
>   * This is the Target Interface Command Line Interface. You need
>   * start the RTEMS monitor.
> diff --git a/cpukit/include/rtems/capture.h
> b/cpukit/include/rtems/capture.h
> index 1531bb87c3..a0b862bca1 100644
> --- a/cpukit/include/rtems/capture.h
> +++ b/cpukit/include/rtems/capture.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/capture.h
> + * @file
>   *
>   * @brief Capture Engine Component of the RTEMS Measurement and
>   * Monitoring System
> diff --git a/cpukit/include/rtems/captureimpl.h
> b/cpukit/include/rtems/captureimpl.h
> index 4c4cbe66c3..110ef94d6b 100644
> --- a/cpukit/include/rtems/captureimpl.h
> +++ b/cpukit/include/rtems/captureimpl.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/captureimpl.h
> + * @file
>   *
>   * @brief Capture Implementation file
>   *
> diff --git a/cpukit/include/rtems/concat.h b/cpukit/include/rtems/concat.h
> index 022f1bfd39..f3072466b5 100644
> --- a/cpukit/include/rtems/concat.h
> +++ b/cpukit/include/rtems/concat.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/concat.h
> + * @file
>   *
>   * This include file defines ANSI concatenation macros.
>   */
> diff --git a/cpukit/include/rtems/cpuuse.h b/cpukit/include/rtems/cpuuse.h
> index 23f58faf1b..325ef0def3 100644
> --- a/cpukit/include/rtems/cpuuse.h
> +++ b/cpukit/include/rtems/cpuuse.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/cpuuse.h
> + * @file
>   *
>   * @defgroup libmisc_cpuuse CPU Usage
>   *
> diff --git a/cpukit/include/rtems/devfs.h b/cpukit/include/rtems/devfs.h
> index b0a9197eca..ff4dfe09bc 100644
> --- a/cpukit/include/rtems/devfs.h
> +++ b/cpukit/include/rtems/devfs.h
> @@ -1,5 +1,5 @@
>  /**
> -* @file
> +* @file
>  *
>  * @brief Device Only File System
>  *
> diff --git a/cpukit/include/rtems/devzero.h
> b/cpukit/include/rtems/devzero.h
> index bc47d3ea09..7c282dc8b3 100644
> --- a/cpukit/include/rtems/devzero.h
> +++ b/cpukit/include/rtems/devzero.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/devzero.h
> + * @file
>   *
>   * @brief RTEMS /dev/zero Device Driver
>   *
> diff --git a/cpukit/include/rtems/endian.h b/cpukit/include/rtems/endian.h
> index 802cc4bb91..03a089d5a1 100644
> --- a/cpukit/include/rtems/endian.h
> +++ b/cpukit/include/rtems/endian.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/endian.h
> + * @file
>   *
>   * This include file provides endian information about the target.
>   */
> diff --git a/cpukit/include/rtems/error.h b/cpukit/include/rtems/error.h
> index 617f59642b..8277a62261 100644
> --- a/cpukit/include/rtems/error.h
> +++ b/cpukit/include/rtems/error.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/error.h
> + * @file
>   *
>   * @brief RTEMS Error Reporting
>   *
> diff --git a/cpukit/include/rtems/fb.h b/cpukit/include/rtems/fb.h
> index bb5cb23805..3ff0783e51 100644
> --- a/cpukit/include/rtems/fb.h
> +++ b/cpukit/include/rtems/fb.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/fb.h
> + * @file
>   *
>   * @brief Frame Buffer Device Driver
>   *
> diff --git a/cpukit/include/rtems/framebuffer.h
> b/cpukit/include/rtems/framebuffer.h
> index ab1e5c73bd..7828be1cf8 100644
> --- a/cpukit/include/rtems/framebuffer.h
> +++ b/cpukit/include/rtems/framebuffer.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/framebuffer.h
> + * @file
>   *
>   * @brief Frame Buffer Device Driver for all Boards
>   *
> diff --git a/cpukit/include/rtems/fs.h b/cpukit/include/rtems/fs.h
> index 4801007c1a..90e9eb8dd6 100644
> --- a/cpukit/include/rtems/fs.h
> +++ b/cpukit/include/rtems/fs.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/fs.h
> + * @file
>   *
>   * @brief Basic Filesystem Types
>   *
> diff --git a/cpukit/include/rtems/fsmount.h
> b/cpukit/include/rtems/fsmount.h
> index 441b0d68ef..7c6d4558c3 100644
> --- a/cpukit/include/rtems/fsmount.h
> +++ b/cpukit/include/rtems/fsmount.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/fsmount.h
> + * @file
>   *
>   * @defgroup rtems_fstab File System Mount Support
>   *
> diff --git a/cpukit/include/rtems/gxx_wrappers.h
> b/cpukit/include/rtems/gxx_wrappers.h
> index 94502b937f..e462d27d66 100644
> --- a/cpukit/include/rtems/gxx_wrappers.h
> +++ b/cpukit/include/rtems/gxx_wrappers.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/gxx_wrappers.h
> + * @file
>   *
>   * RTEMS threads compatibility routines for libgcc2.
>   */
> diff --git a/cpukit/include/rtems/inttypes.h
> b/cpukit/include/rtems/inttypes.h
> index 5af23b22c7..406e7dd527 100644
> --- a/cpukit/include/rtems/inttypes.h
> +++ b/cpukit/include/rtems/inttypes.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/inttypes.h
> + * @file
>   *
>   * @brief Provide printf() PRIxxx Constante Beyond Standards
>   *
> diff --git a/cpukit/include/rtems/iosupp.h b/cpukit/include/rtems/iosupp.h
> index 9fe8a6ab1d..84ede0bd74 100644
> --- a/cpukit/include/rtems/iosupp.h
> +++ b/cpukit/include/rtems/iosupp.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/iosupp.h
> + * @file
>   *
>   * This include file defines some special characters of interest.
>   */
> diff --git a/cpukit/include/rtems/irq.h b/cpukit/include/rtems/irq.h
> index e92d0dd5f5..7e50a0b6a1 100644
> --- a/cpukit/include/rtems/irq.h
> +++ b/cpukit/include/rtems/irq.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/irq.h
> + * @file
>   *
>   * This include file describe the data structure and the functions
> implemented
>   * by rtems to write interrupt handlers.
> diff --git a/cpukit/include/rtems/malloc.h b/cpukit/include/rtems/malloc.h
> index 6fdab3d02f..7cdce1f94a 100644
> --- a/cpukit/include/rtems/malloc.h
> +++ b/cpukit/include/rtems/malloc.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/malloc.h
> + * @file
>   *
>   * This file defines the interface to RTEMS extensions to the Malloc
> Family.
>   */
> diff --git a/cpukit/include/rtems/monitor.h
> b/cpukit/include/rtems/monitor.h
> index d973687396..d0a79c03be 100644
> --- a/cpukit/include/rtems/monitor.h
> +++ b/cpukit/include/rtems/monitor.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/monitor.h
> + * @file
>   *
>   * @brief The RTEMS Monitor Task
>   */
> diff --git a/cpukit/include/rtems/mouse_parser.h
> b/cpukit/include/rtems/mouse_parser.h
> index 27bea1bbbc..f61c5f1edc 100644
> --- a/cpukit/include/rtems/mouse_parser.h
> +++ b/cpukit/include/rtems/mouse_parser.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/mouse_parser.h
> + * @file
>   *
>   * @brief Initialize Mouse Parser Engine
>   *
> diff --git a/cpukit/include/rtems/mw_uid.h b/cpukit/include/rtems/mw_uid.h
> index aa88392d26..2222494254 100644
> --- a/cpukit/include/rtems/mw_uid.h
> +++ b/cpukit/include/rtems/mw_uid.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/mw_uid.h
> + * @file
>   *
>   * @defgroup libmisc_fb_mw Input Devices for MicroWindows
>   *
> diff --git a/cpukit/include/rtems/nvdisk-sram.h
> b/cpukit/include/rtems/nvdisk-sram.h
> index 3acaf600b6..b455a2bb5e 100644
> --- a/cpukit/include/rtems/nvdisk-sram.h
> +++ b/cpukit/include/rtems/nvdisk-sram.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/nvdisk-sram.h
> + * @file
>   *
>   * This driver maps an NV disk to static RAM. You can use this
>   */
> diff --git a/cpukit/include/rtems/nvdisk.h b/cpukit/include/rtems/nvdisk.h
> index a42e07a23f..0fa9390627 100644
> --- a/cpukit/include/rtems/nvdisk.h
> +++ b/cpukit/include/rtems/nvdisk.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/nvdisk.h
> + * @file
>   *
>   * @brief Non-volatile Disk Block Device Implementation
>   */
> diff --git a/cpukit/include/rtems/pci.h b/cpukit/include/rtems/pci.h
> index 46ce2ddf3e..efb84fc8f7 100644
> --- a/cpukit/include/rtems/pci.h
> +++ b/cpukit/include/rtems/pci.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/pci.h
> + * @file
>   *
>   * PCI defines and function prototypes
>   */
> diff --git a/cpukit/include/rtems/posix/timer.h
> b/cpukit/include/rtems/posix/timer.h
> index 0b7a91e256..bcbf07a65a 100644
> --- a/cpukit/include/rtems/posix/timer.h
> +++ b/cpukit/include/rtems/posix/timer.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file
> + * @file
>   *
>   * @brief POSIX Timers Internal Support
>   *
> diff --git a/cpukit/include/rtems/print.h b/cpukit/include/rtems/print.h
> index 2fd744e44c..6c98b97f97 100644
> --- a/cpukit/include/rtems/print.h
> +++ b/cpukit/include/rtems/print.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/print.h
> + * @file
>   *
>   * @brief User print interface to the bspIO print plug in.
>   *
> diff --git a/cpukit/include/rtems/printer.h
> b/cpukit/include/rtems/printer.h
> index c25c4329c7..dbd887221e 100644
> --- a/cpukit/include/rtems/printer.h
> +++ b/cpukit/include/rtems/printer.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/print.h
> + * @file
>   *
>   * @brief User print interface to the bspIO print plug in.
>   *
> diff --git a/cpukit/include/rtems/qreslib.h
> b/cpukit/include/rtems/qreslib.h
> index 3de8668fdb..88d9aba721 100644
> --- a/cpukit/include/rtems/qreslib.h
> +++ b/cpukit/include/rtems/qreslib.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file qreslib.h
> + * @file
>   *
>   * @brief Constants and Structures Associated
>   * with the QoS RES library in RTEMS
> diff --git a/cpukit/include/rtems/rtems/asr.h
> b/cpukit/include/rtems/rtems/asr.h
> index b2fa02ce9e..9bc6b433bb 100644
> --- a/cpukit/include/rtems/rtems/asr.h
> +++ b/cpukit/include/rtems/rtems/asr.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/rtems/asr.h
> + * @file
>   *
>   * @defgroup ClassicASR ASR Support
>   *
> diff --git a/cpukit/include/rtems/rtems/attr.h
> b/cpukit/include/rtems/rtems/attr.h
> index 7e8fa4818a..758d41df1e 100644
> --- a/cpukit/include/rtems/rtems/attr.h
> +++ b/cpukit/include/rtems/rtems/attr.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/rtems/attr.h
> + * @file
>   *
>   * @defgroup ClassicAttributes Attributes
>   *
> diff --git a/cpukit/include/rtems/rtems/clock.h
> b/cpukit/include/rtems/rtems/clock.h
> index 77b379f285..d08d2cd1b4 100644
> --- a/cpukit/include/rtems/rtems/clock.h
> +++ b/cpukit/include/rtems/rtems/clock.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/rtems/clock.h
> + * @file
>   *
>   * @defgroup ClassicClock Clocks
>   *
> diff --git a/cpukit/include/rtems/rtems/config.h
> b/cpukit/include/rtems/rtems/config.h
> index a3e3988cd6..ad1dcb6dbd 100644
> --- a/cpukit/include/rtems/rtems/config.h
> +++ b/cpukit/include/rtems/rtems/config.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/rtems/config.h
> + * @file
>   *
>   * @defgroup ClassicConfig Configuration
>   *
> diff --git a/cpukit/include/rtems/rtems/eventmp.h
> b/cpukit/include/rtems/rtems/eventmp.h
> index a80e60c4e0..5f5f2248c4 100644
> --- a/cpukit/include/rtems/rtems/eventmp.h
> +++ b/cpukit/include/rtems/rtems/eventmp.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/rtems/eventmp.h
> + * @file
>   *
>   * @defgroup ClassicEventMP Event MP Support
>   *
> diff --git a/cpukit/include/rtems/rtems/intr.h
> b/cpukit/include/rtems/rtems/intr.h
> index 4a9ac9f478..be216a013c 100644
> --- a/cpukit/include/rtems/rtems/intr.h
> +++ b/cpukit/include/rtems/rtems/intr.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file rtems/rtems/intr.h
> + *  @file
>   *
>   * @defgroup ClassicINTR Interrupts
>   *
> diff --git a/cpukit/include/rtems/rtems/mainpage.h
> b/cpukit/include/rtems/rtems/mainpage.h
> index 8a6ddbb8ad..eb8faba925 100644
> --- a/cpukit/include/rtems/rtems/mainpage.h
> +++ b/cpukit/include/rtems/rtems/mainpage.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/rtems/mainpage.h
> + * @file
>   *
>   * This file exists to provide a top level description of RTEMS for
> Doxygen.
>   */
> diff --git a/cpukit/include/rtems/rtems/modes.h
> b/cpukit/include/rtems/rtems/modes.h
> index 4c9f74edba..6afb0c9def 100644
> --- a/cpukit/include/rtems/rtems/modes.h
> +++ b/cpukit/include/rtems/rtems/modes.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/rtems/modes.h
> + * @file
>   *
>   * @defgroup ClassicModes Modes
>   *
> diff --git a/cpukit/include/rtems/rtems/mp.h
> b/cpukit/include/rtems/rtems/mp.h
> index f1b93b6751..7a8a1ea5ec 100644
> --- a/cpukit/include/rtems/rtems/mp.h
> +++ b/cpukit/include/rtems/rtems/mp.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/rtems/mp.h
> + * @file
>   *
>   * @defgroup ClassicMP Multiprocessing
>   *
> diff --git a/cpukit/include/rtems/rtems/msgmp.h
> b/cpukit/include/rtems/rtems/msgmp.h
> index 1c5818b44e..b7aa3f993f 100644
> --- a/cpukit/include/rtems/rtems/msgmp.h
> +++ b/cpukit/include/rtems/rtems/msgmp.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/rtems/msgmp.h
> + * @file
>   *
>   * @brief Message Manager MP Support
>   *
> diff --git a/cpukit/include/rtems/rtems/object.h
> b/cpukit/include/rtems/rtems/object.h
> index 2652915462..ea64f1d062 100644
> --- a/cpukit/include/rtems/rtems/object.h
> +++ b/cpukit/include/rtems/rtems/object.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/rtems/object.h
> + * @file
>   *
>   * @defgroup ClassicClassInfo Object Class Information
>   *
> diff --git a/cpukit/include/rtems/rtems/options.h
> b/cpukit/include/rtems/rtems/options.h
> index 752aefda2e..de47c320ba 100644
> --- a/cpukit/include/rtems/rtems/options.h
> +++ b/cpukit/include/rtems/rtems/options.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/rtems/options.h
> + * @file
>   *
>   * @defgroup ClassicOptions Classic API Options
>   *
> diff --git a/cpukit/include/rtems/rtems/partmp.h
> b/cpukit/include/rtems/rtems/partmp.h
> index 5fffd68480..26bdd9c1cf 100644
> --- a/cpukit/include/rtems/rtems/partmp.h
> +++ b/cpukit/include/rtems/rtems/partmp.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/rtems/partmp.h
> + * @file
>   *
>   * @brief MP Support in Partition Manager
>   *
> diff --git a/cpukit/include/rtems/rtems/ratemon.h
> b/cpukit/include/rtems/rtems/ratemon.h
> index 5f956de791..6cf8a7c938 100644
> --- a/cpukit/include/rtems/rtems/ratemon.h
> +++ b/cpukit/include/rtems/rtems/ratemon.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/rtems/ratemon.h
> + * @file
>   *
>   * @defgroup ClassicRateMon Rate Monotonic Scheduler
>   *
> diff --git a/cpukit/include/rtems/rtems/semmp.h
> b/cpukit/include/rtems/rtems/semmp.h
> index 31774c39ba..e84ea127ea 100644
> --- a/cpukit/include/rtems/rtems/semmp.h
> +++ b/cpukit/include/rtems/rtems/semmp.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/rtems/semmp.h
> + * @file
>   *
>   * @defgroup ClassicSEM Semaphore MP Support
>   *
> diff --git a/cpukit/include/rtems/rtems/signalmp.h
> b/cpukit/include/rtems/rtems/signalmp.h
> index 57b8682c58..b22e92d9b3 100644
> --- a/cpukit/include/rtems/rtems/signalmp.h
> +++ b/cpukit/include/rtems/rtems/signalmp.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/rtems/signalmp.h
> + * @file
>   *
>   * @brief Signal MP Support
>   *
> diff --git a/cpukit/include/rtems/rtems/status.h
> b/cpukit/include/rtems/rtems/status.h
> index c54404ba14..646a382b38 100644
> --- a/cpukit/include/rtems/rtems/status.h
> +++ b/cpukit/include/rtems/rtems/status.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/rtems/status.h
> + * @file
>   *
>   * @defgroup ClassicStatus Status Codes
>   *
> diff --git a/cpukit/include/rtems/rtems/taskmp.h
> b/cpukit/include/rtems/rtems/taskmp.h
> index e2d70a924e..c268fc6551 100644
> --- a/cpukit/include/rtems/rtems/taskmp.h
> +++ b/cpukit/include/rtems/rtems/taskmp.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/rtems/taskmp.h
> + * @file
>   *
>   * @defgroup ClassicTaskMP Task MP Support
>   *
> diff --git a/cpukit/include/rtems/score/address.h
> b/cpukit/include/rtems/score/address.h
> index 00fc105e48..28502e25e4 100644
> --- a/cpukit/include/rtems/score/address.h
> +++ b/cpukit/include/rtems/score/address.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  rtems/score/address.h
> + *  @file
>   *
>   *  @brief Information Required to Manipulate Physical Addresses
>   *
> diff --git a/cpukit/include/rtems/score/context.h
> b/cpukit/include/rtems/score/context.h
> index 990a602396..317575538a 100644
> --- a/cpukit/include/rtems/score/context.h
> +++ b/cpukit/include/rtems/score/context.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  rtems/score/context.h
> + *  @file
>   *
>   *  @brief Information About Each Thread's Context
>   *
> diff --git a/cpukit/include/rtems/score/copyrt.h
> b/cpukit/include/rtems/score/copyrt.h
> index 17c925a008..8647bd9d0d 100644
> --- a/cpukit/include/rtems/score/copyrt.h
> +++ b/cpukit/include/rtems/score/copyrt.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  rtems/score/copyrt.h
> + *  @file
>   *
>   *  @brief Copyright Notice for RTEMS
>   *
> diff --git a/cpukit/include/rtems/score/corebarrier.h
> b/cpukit/include/rtems/score/corebarrier.h
> index ba706be3e3..785c7729a3 100644
> --- a/cpukit/include/rtems/score/corebarrier.h
> +++ b/cpukit/include/rtems/score/corebarrier.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file rtems/score/corebarrier.h
> + *  @file
>   *
>   *  @brief Constants and Structures Associated with the Barrier Handler
>   *
> diff --git a/cpukit/include/rtems/score/coremsg.h
> b/cpukit/include/rtems/score/coremsg.h
> index e0a7e05bbf..90bf9d8a9e 100644
> --- a/cpukit/include/rtems/score/coremsg.h
> +++ b/cpukit/include/rtems/score/coremsg.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  rtems/score/coremsg.h
> + *  @file
>   *
>   *  @brief Constants and Structures Associated with the Message Queue
> Handler.
>   *
> diff --git a/cpukit/include/rtems/score/coresem.h
> b/cpukit/include/rtems/score/coresem.h
> index f9d3ac8fd5..4df7b6c49a 100644
> --- a/cpukit/include/rtems/score/coresem.h
> +++ b/cpukit/include/rtems/score/coresem.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  rtems/score/coresem.h
> + *  @file
>   *
>   *  @brief Data Associated with the Counting Semaphore Handler
>   *
> diff --git a/cpukit/include/rtems/score/interr.h
> b/cpukit/include/rtems/score/interr.h
> index 54e6ec759d..a0ad7a5e36 100644
> --- a/cpukit/include/rtems/score/interr.h
> +++ b/cpukit/include/rtems/score/interr.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  rtems/score/interr.h
> + *  @file
>   *
>   *  @brief Constants and Prototypes Related to the Internal Error Handler
>   *
> diff --git a/cpukit/include/rtems/score/isr.h
> b/cpukit/include/rtems/score/isr.h
> index f4e2eec3cf..0d6f2a21ee 100644
> --- a/cpukit/include/rtems/score/isr.h
> +++ b/cpukit/include/rtems/score/isr.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  rtems/score/isr.h
> + *  @file
>   *
>   *  @brief Data Related to the Management of Processor Interrupt Levels
>   *
> diff --git a/cpukit/include/rtems/score/isrlevel.h
> b/cpukit/include/rtems/score/isrlevel.h
> index abfb1b67fc..9222e1871c 100644
> --- a/cpukit/include/rtems/score/isrlevel.h
> +++ b/cpukit/include/rtems/score/isrlevel.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  rtems/score/isrlevel.h
> + *  @file
>   *
>   *  @brief ISR Level Type
>   *
> diff --git a/cpukit/include/rtems/score/mppkt.h
> b/cpukit/include/rtems/score/mppkt.h
> index d6d41261f6..74d7e3d55b 100644
> --- a/cpukit/include/rtems/score/mppkt.h
> +++ b/cpukit/include/rtems/score/mppkt.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  rtems/score/mppkt.h
> + *  @file
>   *
>   *  @brief Specification for the Packet Handler
>   *
> diff --git a/cpukit/include/rtems/score/object.h
> b/cpukit/include/rtems/score/object.h
> index f75d1de2ab..a9b5ab1d1d 100644
> --- a/cpukit/include/rtems/score/object.h
> +++ b/cpukit/include/rtems/score/object.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file  rtems/score/object.h
> + * @file
>   *
>   * @brief Constants and Structures Associated with the Object Handler
>   *
> diff --git a/cpukit/include/rtems/score/objectmp.h
> b/cpukit/include/rtems/score/objectmp.h
> index 5c9f4f74e3..d52b83fdff 100644
> --- a/cpukit/include/rtems/score/objectmp.h
> +++ b/cpukit/include/rtems/score/objectmp.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  rtems/score/objectmp.h
> + *  @file
>   *
>   *  @brief Data Associated with the Manipulation of Global RTEMS Objects
>   *
> diff --git a/cpukit/include/rtems/score/percpu.h
> b/cpukit/include/rtems/score/percpu.h
> index 22c5c30a00..b9f23ac394 100644
> --- a/cpukit/include/rtems/score/percpu.h
> +++ b/cpukit/include/rtems/score/percpu.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  rtems/score/percpu.h
> + *  @file
>   *
>   *  This include file defines the per CPU information required
>   *  by RTEMS.
> diff --git a/cpukit/include/rtems/score/prioritybitmap.h
> b/cpukit/include/rtems/score/prioritybitmap.h
> index 40638dd628..ac769c1ea4 100644
> --- a/cpukit/include/rtems/score/prioritybitmap.h
> +++ b/cpukit/include/rtems/score/prioritybitmap.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  rtems/score/prioritybitmap.h
> + *  @file
>   *
>   *  @brief Manipulation Routines for the Bitmap Priority Queue
> Implementation
>   *
> diff --git a/cpukit/include/rtems/score/rbtree.h
> b/cpukit/include/rtems/score/rbtree.h
> index fea3d13695..51f9125dda 100644
> --- a/cpukit/include/rtems/score/rbtree.h
> +++ b/cpukit/include/rtems/score/rbtree.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  rtems/score/rbtree.h
> + *  @file
>   *
>   *  @brief Constants and Structures Associated with the Red-Black Tree
> Handler
>   *
> diff --git a/cpukit/include/rtems/score/scheduler.h
> b/cpukit/include/rtems/score/scheduler.h
> index fe6315daef..c36353cf6b 100644
> --- a/cpukit/include/rtems/score/scheduler.h
> +++ b/cpukit/include/rtems/score/scheduler.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  rtems/score/scheduler.h
> + *  @file
>   *
>   *  @brief Constants and Structures Associated with the Scheduler
>   *
> diff --git a/cpukit/include/rtems/score/schedulercbs.h
> b/cpukit/include/rtems/score/schedulercbs.h
> index 635abce125..2b5ffb94aa 100644
> --- a/cpukit/include/rtems/score/schedulercbs.h
> +++ b/cpukit/include/rtems/score/schedulercbs.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  rtems/score/schedulercbs.h
> + *  @file
>   *
>   *  @brief Thread manipulation for the CBS scheduler
>   *
> diff --git a/cpukit/include/rtems/score/scheduleredf.h
> b/cpukit/include/rtems/score/scheduleredf.h
> index 91c303ca56..c3849e825e 100644
> --- a/cpukit/include/rtems/score/scheduleredf.h
> +++ b/cpukit/include/rtems/score/scheduleredf.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  rtems/score/scheduleredf.h
> + *  @file
>   *
>   *  @brief Data Related to the Manipulation of Threads for the EDF
> Scheduler
>   *
> diff --git a/cpukit/include/rtems/score/schedulerpriority.h
> b/cpukit/include/rtems/score/schedulerpriority.h
> index f5ae66102d..ad146076e5 100644
> --- a/cpukit/include/rtems/score/schedulerpriority.h
> +++ b/cpukit/include/rtems/score/schedulerpriority.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  rtems/score/schedulerpriority.h
> + *  @file
>   *
>   *  @brief Thread Manipulation with the Priority-Based Scheduler
>   *
> diff --git a/cpukit/include/rtems/score/schedulersimple.h
> b/cpukit/include/rtems/score/schedulersimple.h
> index 0d410d5676..280105568f 100644
> --- a/cpukit/include/rtems/score/schedulersimple.h
> +++ b/cpukit/include/rtems/score/schedulersimple.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  rtems/score/schedulersimple.h
> + *  @file
>   *
>   *  @brief Manipulation of Threads Simple-Priority-Based Ready Queue
>   *
> diff --git a/cpukit/include/rtems/score/stack.h
> b/cpukit/include/rtems/score/stack.h
> index 9622495092..62be3ea5ef 100644
> --- a/cpukit/include/rtems/score/stack.h
> +++ b/cpukit/include/rtems/score/stack.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  rtems/score/stack.h
> + *  @file
>   *
>   *  @brief Information About the Thread Stack Handler
>   *
> diff --git a/cpukit/include/rtems/score/states.h
> b/cpukit/include/rtems/score/states.h
> index ba59af6907..68aa1d699f 100644
> --- a/cpukit/include/rtems/score/states.h
> +++ b/cpukit/include/rtems/score/states.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  rtems/score/states.h
> + *  @file
>   *
>   *  @brief Thread Execution State Information
>   *
> diff --git a/cpukit/include/rtems/score/thread.h
> b/cpukit/include/rtems/score/thread.h
> index 9bf920d5fb..061d7cb14f 100644
> --- a/cpukit/include/rtems/score/thread.h
> +++ b/cpukit/include/rtems/score/thread.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  rtems/score/thread.h
> + *  @file
>   *
>   *  @brief Constants and Structures Related with the Thread Control Block
>   *
> diff --git a/cpukit/include/rtems/score/threadmp.h
> b/cpukit/include/rtems/score/threadmp.h
> index 9cde35b649..bcc71f7b88 100644
> --- a/cpukit/include/rtems/score/threadmp.h
> +++ b/cpukit/include/rtems/score/threadmp.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  rtems/score/threadmp.h
> + *  @file
>   *
>   *  @brief Multiprocessing Portion of the Thread Package
>   *
> diff --git a/cpukit/include/rtems/score/threadqimpl.h
> b/cpukit/include/rtems/score/threadqimpl.h
> index 8d537cc9e3..789184c0dd 100644
> --- a/cpukit/include/rtems/score/threadqimpl.h
> +++ b/cpukit/include/rtems/score/threadqimpl.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  rtems/score/threadq.h
> + *  @file
>   *
>   *  Constants and Structures Associated with the Manipulation of Objects
>   *
> diff --git a/cpukit/include/rtems/score/timespec.h
> b/cpukit/include/rtems/score/timespec.h
> index 72a000177f..a453aadf5e 100644
> --- a/cpukit/include/rtems/score/timespec.h
> +++ b/cpukit/include/rtems/score/timespec.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  rtems/score/timespec.h
> + *  @file
>   *
>   *  This include file contains helpers for manipulating timespecs.
>   */
> diff --git a/cpukit/include/rtems/score/timestamp.h
> b/cpukit/include/rtems/score/timestamp.h
> index 1e6a25ef28..002584d3d8 100644
> --- a/cpukit/include/rtems/score/timestamp.h
> +++ b/cpukit/include/rtems/score/timestamp.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  rtems/score/timestamp.h
> + *  @file
>   *
>   *  @brief Helpers for Manipulating Timestamps
>   *
> diff --git a/cpukit/include/rtems/score/timestampimpl.h
> b/cpukit/include/rtems/score/timestampimpl.h
> index 555d9354f2..88ec4f2c92 100644
> --- a/cpukit/include/rtems/score/timestampimpl.h
> +++ b/cpukit/include/rtems/score/timestampimpl.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  rtems/score/timestamp.h
> + *  @file
>   *
>   *  @brief Helpers for Manipulating Timestamps
>   *
> diff --git a/cpukit/include/rtems/score/wkspace.h
> b/cpukit/include/rtems/score/wkspace.h
> index 3676ff28c4..cbb4011824 100644
> --- a/cpukit/include/rtems/score/wkspace.h
> +++ b/cpukit/include/rtems/score/wkspace.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file rtems/score/wkspace.h
> + *  @file
>   *
>   *  @brief Information Related to the RAM Workspace
>   *
> diff --git a/cpukit/include/rtems/seterr.h b/cpukit/include/rtems/seterr.h
> index 22fddc824e..99997745b6 100644
> --- a/cpukit/include/rtems/seterr.h
> +++ b/cpukit/include/rtems/seterr.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  rtems/seterr.h
> + *  @file
>   *
>   *  @brief Data which Ease the Burden of Consistently Setting Errno
>   *
> diff --git a/cpukit/include/rtems/shell.h b/cpukit/include/rtems/shell.h
> index 98ddf0a958..973db16605 100644
> --- a/cpukit/include/rtems/shell.h
> +++ b/cpukit/include/rtems/shell.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/shell.h
> + * @file
>   *
>   * @brief Instantatiate a New Terminal Shell
>   */
> diff --git a/cpukit/include/rtems/shellconfig.h
> b/cpukit/include/rtems/shellconfig.h
> index 9f68b313fb..3e87d472d6 100644
> --- a/cpukit/include/rtems/shellconfig.h
> +++ b/cpukit/include/rtems/shellconfig.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/shellconfig.h
> + * @file
>   *
>   * RTEMS Shell Command Set Configuration
>   */
> diff --git a/cpukit/include/rtems/spurious.h
> b/cpukit/include/rtems/spurious.h
> index 049f3bf3a0..2bddeeb3c8 100644
> --- a/cpukit/include/rtems/spurious.h
> +++ b/cpukit/include/rtems/spurious.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/spurious.h
> + * @file
>   *
>   * This file describes the Spurious Interrupt Driver for all boards.
>   */
> diff --git a/cpukit/include/rtems/stackchk.h
> b/cpukit/include/rtems/stackchk.h
> index b7d906ec22..22f2730481 100644
> --- a/cpukit/include/rtems/stackchk.h
> +++ b/cpukit/include/rtems/stackchk.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/stackchk.h
> + * @file
>   *
>   * @defgroup libmisc_stackchk Stack Checker Mechanism
>   *
> diff --git a/cpukit/include/rtems/stringto.h
> b/cpukit/include/rtems/stringto.h
> index 878814da54..53e8147c81 100644
> --- a/cpukit/include/rtems/stringto.h
> +++ b/cpukit/include/rtems/stringto.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/stringto.h
> + * @file
>   *
>   * @defgroup libmisc_conv_help Conversion Helpers
>   *
> diff --git a/cpukit/include/rtems/termiostypes.h
> b/cpukit/include/rtems/termiostypes.h
> index db88cada8b..6930e5958b 100644
> --- a/cpukit/include/rtems/termiostypes.h
> +++ b/cpukit/include/rtems/termiostypes.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/termiostypes.h
> + * @file
>   *
>   * RTEMS termios device support internal data structures
>   */
> diff --git a/cpukit/include/rtems/watchdogdrv.h
> b/cpukit/include/rtems/watchdogdrv.h
> index 3e2ee4d6fe..f05ea80938 100644
> --- a/cpukit/include/rtems/watchdogdrv.h
> +++ b/cpukit/include/rtems/watchdogdrv.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/watchdogdrv.h
> + * @file
>   *
>   *  This file describes the Watchdog Driver for all boards.
>   *  A watchdog is a hardware device that will reset the board
> diff --git a/cpukit/include/sys/statvfs.h b/cpukit/include/sys/statvfs.h
> index cf80478aae..e065a1b46e 100644
> --- a/cpukit/include/sys/statvfs.h
> +++ b/cpukit/include/sys/statvfs.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file
> + * @file
>   *
>   * @brief Interface to the statvfs() Set of API Methods
>   *
> diff --git a/cpukit/libfs/src/dosfs/msdos_statvfs.c
> b/cpukit/libfs/src/dosfs/msdos_statvfs.c
> index a9e61c568f..59781dd7b9 100644
> --- a/cpukit/libfs/src/dosfs/msdos_statvfs.c
> +++ b/cpukit/libfs/src/dosfs/msdos_statvfs.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file msdos_statvfs.c
> + * @file
>   *
>   * @brief Obtain MS-DOS filesystem information
>   * @ingroup libfs_msdos MSDOS FileSystem
> diff --git a/cpukit/libmisc/capture/capture_buffer.h
> b/cpukit/libmisc/capture/capture_buffer.h
> index 5a437bbe98..af75c0204c 100644
> --- a/cpukit/libmisc/capture/capture_buffer.h
> +++ b/cpukit/libmisc/capture/capture_buffer.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file capture_buffer.h
> + * @file
>   *
>   * @brief Capture buffer
>   *
> diff --git a/cpukit/libnetworking/rtems/bsdnet/servers.h
> b/cpukit/libnetworking/rtems/bsdnet/servers.h
> index 8886d05405..a9db74ac3e 100644
> --- a/cpukit/libnetworking/rtems/bsdnet/servers.h
> +++ b/cpukit/libnetworking/rtems/bsdnet/servers.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/rtems_bsdnet.h
> + * @file
>   */
>
>
> diff --git a/cpukit/libnetworking/rtems/mkrootfs.h
> b/cpukit/libnetworking/rtems/mkrootfs.h
> index 8bd443693b..1b1cb29a47 100644
> --- a/cpukit/libnetworking/rtems/mkrootfs.h
> +++ b/cpukit/libnetworking/rtems/mkrootfs.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/mkrootfs.h
> + * @file
>   *
>   * RTEMS Root FS creation support.
>   */
> diff --git a/cpukit/libnetworking/rtems/rtems_bsdnet.h
> b/cpukit/libnetworking/rtems/rtems_bsdnet.h
> index 74626378e3..4607f42477 100644
> --- a/cpukit/libnetworking/rtems/rtems_bsdnet.h
> +++ b/cpukit/libnetworking/rtems/rtems_bsdnet.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/rtems_bsdnet.h
> + * @file
>   */
>
>
> diff --git a/cpukit/rtems/include/rtems/rtems/barriermp.h
> b/cpukit/rtems/include/rtems/rtems/barriermp.h
> index 6aa13f0537..d215ecdb5f 100644
> --- a/cpukit/rtems/include/rtems/rtems/barriermp.h
> +++ b/cpukit/rtems/include/rtems/rtems/barriermp.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/rtems/barriermp.h
> + * @file
>   *
>   * @brief MP Support in the Barrier Manager
>   *
> diff --git a/cpukit/rtems/src/timerserver.c
> b/cpukit/rtems/src/timerserver.c
> index 55c3d96b9b..2ebceca1ba 100644
> --- a/cpukit/rtems/src/timerserver.c
> +++ b/cpukit/rtems/src/timerserver.c
> @@ -1,5 +1,5 @@
>  /**
> - *  @file timerserver.c
> + *  @file
>   *
>   *  Timer Manager - rtems_timer_initiate_server directive along with
>   *  the Timer Server Body and support routines
> diff --git a/cpukit/score/cpu/epiphany/include/rtems/asm.h
> b/cpukit/score/cpu/epiphany/include/rtems/asm.h
> index 87e0cca1cb..219ed81846 100644
> --- a/cpukit/score/cpu/epiphany/include/rtems/asm.h
> +++ b/cpukit/score/cpu/epiphany/include/rtems/asm.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/asm.h
> + * @file
>   *
>   *  This include file attempts to address the problems
>   *  caused by incompatible flavors of assemblers and
> diff --git a/cpukit/score/cpu/epiphany/include/rtems/score/cpu.h
> b/cpukit/score/cpu/epiphany/include/rtems/score/cpu.h
> index fe42c1f80d..bfea847fc0 100644
> --- a/cpukit/score/cpu/epiphany/include/rtems/score/cpu.h
> +++ b/cpukit/score/cpu/epiphany/include/rtems/score/cpu.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/score/cpu.h
> + * @file
>   */
>
>  /*
> diff --git a/cpukit/score/cpu/epiphany/include/rtems/score/epiphany.h
> b/cpukit/score/cpu/epiphany/include/rtems/score/epiphany.h
> index 60d975581f..3eeddec421 100644
> --- a/cpukit/score/cpu/epiphany/include/rtems/score/epiphany.h
> +++ b/cpukit/score/cpu/epiphany/include/rtems/score/epiphany.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/score/epiphany.h
> + * @file
>   */
>
>  /*
> diff --git a/cpukit/score/cpu/m68k/include/rtems/score/cpu.h
> b/cpukit/score/cpu/m68k/include/rtems/score/cpu.h
> index 2d48cb08e1..94dcae3199 100644
> --- a/cpukit/score/cpu/m68k/include/rtems/score/cpu.h
> +++ b/cpukit/score/cpu/m68k/include/rtems/score/cpu.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file
> + * @file
>   *
>   * @brief Motorola M68K CPU Dependent Source
>   *
> diff --git a/cpukit/score/cpu/mips/include/rtems/mips/idtcpu.h
> b/cpukit/score/cpu/mips/include/rtems/mips/idtcpu.h
> index 927bbec133..b26af3e465 100644
> --- a/cpukit/score/cpu/mips/include/rtems/mips/idtcpu.h
> +++ b/cpukit/score/cpu/mips/include/rtems/mips/idtcpu.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file idtcpu.h
> + *  @file
>   *
>   *  @brief CPU Related Definitions
>   *
> diff --git a/cpukit/score/cpu/mips/include/rtems/mips/iregdef.h
> b/cpukit/score/cpu/mips/include/rtems/mips/iregdef.h
> index 5d41074184..d43a05b53b 100644
> --- a/cpukit/score/cpu/mips/include/rtems/mips/iregdef.h
> +++ b/cpukit/score/cpu/mips/include/rtems/mips/iregdef.h
> @@ -1,5 +1,5 @@
>  /**
> - *  @file iregdef.h
> + *  @file
>   *
>   *  @brief IDT R3000 Register Structure
>   *
> diff --git a/cpukit/score/cpu/mips/include/rtems/score/mips.h
> b/cpukit/score/cpu/mips/include/rtems/score/mips.h
> index 3b6115e9b6..e4a98506bf 100644
> --- a/cpukit/score/cpu/mips/include/rtems/score/mips.h
> +++ b/cpukit/score/cpu/mips/include/rtems/score/mips.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/score/mips.h
> + * @file
>   *
>   * @brief Information to build RTEMS for a "no cpu" while in protected
> mode.
>   *
> diff --git a/cpukit/score/cpu/moxie/include/rtems/asm.h
> b/cpukit/score/cpu/moxie/include/rtems/asm.h
> index fdb182f32f..e0d404dced 100644
> --- a/cpukit/score/cpu/moxie/include/rtems/asm.h
> +++ b/cpukit/score/cpu/moxie/include/rtems/asm.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/asm.h
> + * @file
>   *
>   *  This include file attempts to address the problems
>   *  caused by incompatible flavors of assemblers and
> diff --git a/cpukit/score/cpu/moxie/include/rtems/score/cpu.h
> b/cpukit/score/cpu/moxie/include/rtems/score/cpu.h
> index 4e8e8dd804..8485655546 100644
> --- a/cpukit/score/cpu/moxie/include/rtems/score/cpu.h
> +++ b/cpukit/score/cpu/moxie/include/rtems/score/cpu.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/score/cpu.h
> + * @file
>   */
>
>  /*
> diff --git a/cpukit/score/cpu/moxie/include/rtems/score/moxie.h
> b/cpukit/score/cpu/moxie/include/rtems/score/moxie.h
> index 66f771aadf..992f599033 100644
> --- a/cpukit/score/cpu/moxie/include/rtems/score/moxie.h
> +++ b/cpukit/score/cpu/moxie/include/rtems/score/moxie.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/score/moxie.h
> + * @file
>   */
>
>  /*
> diff --git a/cpukit/score/cpu/no_cpu/include/rtems/asm.h
> b/cpukit/score/cpu/no_cpu/include/rtems/asm.h
> index 926e3964e5..58da34cd1b 100644
> --- a/cpukit/score/cpu/no_cpu/include/rtems/asm.h
> +++ b/cpukit/score/cpu/no_cpu/include/rtems/asm.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/asm.h
> + * @file
>   *
>   * @brief Addresses Incompatible Flavors Problems
>   *
> diff --git a/cpukit/score/cpu/no_cpu/include/rtems/score/cpu.h
> b/cpukit/score/cpu/no_cpu/include/rtems/score/cpu.h
> index 6b6094ae10..186ee52f77 100644
> --- a/cpukit/score/cpu/no_cpu/include/rtems/score/cpu.h
> +++ b/cpukit/score/cpu/no_cpu/include/rtems/score/cpu.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/score/cpu.h
> + * @file
>   *
>   * @brief NO_CPU Department Source
>   *
> diff --git a/cpukit/score/cpu/or1k/include/rtems/asm.h
> b/cpukit/score/cpu/or1k/include/rtems/asm.h
> index 4d2c22698b..2b4c1bd6c3 100644
> --- a/cpukit/score/cpu/or1k/include/rtems/asm.h
> +++ b/cpukit/score/cpu/or1k/include/rtems/asm.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/asm.h
> + * @file
>   *
>   *  This include file attempts to address the problems
>   *  caused by incompatible flavors of assemblers and
> diff --git a/cpukit/score/cpu/or1k/include/rtems/score/cpu.h
> b/cpukit/score/cpu/or1k/include/rtems/score/cpu.h
> index 663a1755ba..defa79ae08 100644
> --- a/cpukit/score/cpu/or1k/include/rtems/score/cpu.h
> +++ b/cpukit/score/cpu/or1k/include/rtems/score/cpu.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/score/cpu.h
> + * @file
>   */
>
>  /*
> diff --git a/cpukit/score/cpu/or1k/include/rtems/score/or1k.h
> b/cpukit/score/cpu/or1k/include/rtems/score/or1k.h
> index e1a3ddce42..01ba05c15e 100644
> --- a/cpukit/score/cpu/or1k/include/rtems/score/or1k.h
> +++ b/cpukit/score/cpu/or1k/include/rtems/score/or1k.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/score/or1k.h
> + * @file
>   */
>
>  /*
> diff --git a/cpukit/score/cpu/riscv/include/rtems/asm.h
> b/cpukit/score/cpu/riscv/include/rtems/asm.h
> index c4abc76a27..a2f483536f 100644
> --- a/cpukit/score/cpu/riscv/include/rtems/asm.h
> +++ b/cpukit/score/cpu/riscv/include/rtems/asm.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/asm.h
> + * @file
>   *
>   *  This include file attempts to address the problems
>   *  caused by incompatible flavors of assemblers and
> diff --git a/cpukit/score/cpu/riscv/include/rtems/score/cpu.h
> b/cpukit/score/cpu/riscv/include/rtems/score/cpu.h
> index db46032df2..bb866d8b02 100644
> --- a/cpukit/score/cpu/riscv/include/rtems/score/cpu.h
> +++ b/cpukit/score/cpu/riscv/include/rtems/score/cpu.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/score/cpu.h
> + * @file
>   */
>
>  /*
> diff --git a/cpukit/score/cpu/riscv/include/rtems/score/riscv.h
> b/cpukit/score/cpu/riscv/include/rtems/score/riscv.h
> index 6e7f1370c6..f770578715 100644
> --- a/cpukit/score/cpu/riscv/include/rtems/score/riscv.h
> +++ b/cpukit/score/cpu/riscv/include/rtems/score/riscv.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/score/riscv.h
> + * @file
>   */
>
>  /*
> diff --git a/cpukit/score/cpu/sh/include/rtems/score/cpu.h
> b/cpukit/score/cpu/sh/include/rtems/score/cpu.h
> index 0d633b0c68..a7cd5f89fd 100644
> --- a/cpukit/score/cpu/sh/include/rtems/score/cpu.h
> +++ b/cpukit/score/cpu/sh/include/rtems/score/cpu.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/score/cpu.h
> + * @file
>   */
>
>  /*
> diff --git a/cpukit/score/cpu/x86_64/include/rtems/asm.h
> b/cpukit/score/cpu/x86_64/include/rtems/asm.h
> index 76efc07db3..c11997219d 100644
> --- a/cpukit/score/cpu/x86_64/include/rtems/asm.h
> +++ b/cpukit/score/cpu/x86_64/include/rtems/asm.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/asm.h
> + * @file
>   *
>   * @brief Addresses Incompatible Flavors Problems
>   *
> diff --git a/cpukit/score/cpu/x86_64/include/rtems/score/cpu.h
> b/cpukit/score/cpu/x86_64/include/rtems/score/cpu.h
> index 5716b7a200..e6fa8b7881 100644
> --- a/cpukit/score/cpu/x86_64/include/rtems/score/cpu.h
> +++ b/cpukit/score/cpu/x86_64/include/rtems/score/cpu.h
> @@ -1,5 +1,5 @@
>  /**
> - * @file rtems/score/cpu.h
> + * @file
>   *
>   * @brief x86_64 Dependent Source
>   *
> diff --git a/cpukit/score/src/corerwlockobtainread.c
> b/cpukit/score/src/corerwlockobtainread.c
> index 6969486f28..19685b9131 100644
> --- a/cpukit/score/src/corerwlockobtainread.c
> +++ b/cpukit/score/src/corerwlockobtainread.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file
> + * @file
>   *
>   * @brief Obtain RWLock for reading
>   * @ingroup ScoreRWLock
> diff --git a/cpukit/score/src/schedulersimpleunblock.c
> b/cpukit/score/src/schedulersimpleunblock.c
> index 2f5c8636f5..3c99add581 100644
> --- a/cpukit/score/src/schedulersimpleunblock.c
> +++ b/cpukit/score/src/schedulersimpleunblock.c
> @@ -1,5 +1,5 @@
>  /**
> - * @file
> + * @file
>   *
>   * @brief Scheduler Simple Handler / Unblock
>   * @ingroup ScoreScheduler
> diff --git a/cpukit/score/src/timespecsubtract.c
> b/cpukit/score/src/timespecsubtract.c
> index f45791e6e0..c3006340b2 100644
> --- a/cpukit/score/src/timespecsubtract.c
> +++ b/cpukit/score/src/timespecsubtract.c
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  score/src/timespecsubtract.c
> + *  @file
>   *
>   *  @brief Subtract Two Timespec
>   *  @ingroup Timespec
> diff --git a/cpukit/score/src/timespectoticks.c
> b/cpukit/score/src/timespectoticks.c
> index fb575323d4..05211c9a7d 100644
> --- a/cpukit/score/src/timespectoticks.c
> +++ b/cpukit/score/src/timespectoticks.c
> @@ -1,5 +1,5 @@
>  /**
> - *  @file  score/src/timespectoticks.c
> + *  @file
>   */
>
>  /*
> --
> 2.16.4
>
> _______________________________________________
> devel mailing list
> devel at rtems.org
> http://lists.rtems.org/mailman/listinfo/devel
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.rtems.org/pipermail/devel/attachments/20190227/ac860d36/attachment-0002.html>


More information about the devel mailing list