internal/*.h: skip doxygen

These contents are purely implementation details, not worth appearing in CAPI documents. [ci skip]
2021-06-08 09:40:43 +09:00 · 2021-06-08 09:40:43 +09:00 · daf0c04a47
--- a/internal.h
+++ b/internal.h
@ -1,7 +1,6 @@
 #ifndef RUBY_INTERNAL_H                                  /*-*-C-*-vi:se ft=c:*/
 #define RUBY_INTERNAL_H 1
 /**
- * @file
 * @author     $Author$
 * @date       Tue May 17 11:42:20 JST 2011
 * @copyright  Copyright (C) 2011 Yukihiro Matsumoto
--- a/internal/array.h
+++ b/internal/array.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_ARRAY_H                                 /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_ARRAY_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/bignum.h
+++ b/internal/bignum.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_BIGNUM_H                                /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_BIGNUM_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/bits.h
+++ b/internal/bits.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_BITS_H                                  /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_BITS_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/class.h
+++ b/internal/class.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_CLASS_H                                 /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_CLASS_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/compar.h
+++ b/internal/compar.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_COMPAR_H                                /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_COMPAR_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/compile.h
+++ b/internal/compile.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_COMPILE_H                               /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_COMPILE_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/compilers.h
+++ b/internal/compilers.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_COMPILERS_H                             /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_COMPILERS_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/complex.h
+++ b/internal/complex.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_COMPLEX_H                               /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_COMPLEX_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/cont.h
+++ b/internal/cont.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_CONT_H                                  /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_CONT_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/dir.h
+++ b/internal/dir.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_DIR_H                                   /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_DIR_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/enc.h
+++ b/internal/enc.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_ENC_H                                   /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_ENC_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/encoding.h
+++ b/internal/encoding.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_ENCODING_H                              /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_ENCODING_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/enum.h
+++ b/internal/enum.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_ENUM_H                                  /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_ENUM_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/enumerator.h
+++ b/internal/enumerator.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_ENUMERATOR_H                            /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_ENUMERATOR_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/error.h
+++ b/internal/error.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_ERROR_H                                 /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_ERROR_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/eval.h
+++ b/internal/eval.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_EVAL_H                                  /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_EVAL_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/file.h
+++ b/internal/file.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_FILE_H                                  /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_FILE_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/fixnum.h
+++ b/internal/fixnum.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_FIXNUM_H                                /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_FIXNUM_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/gc.h
+++ b/internal/gc.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_GC_H                                    /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_GC_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/hash.h
+++ b/internal/hash.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_HASH_H                                  /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_HASH_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/imemo.h
+++ b/internal/imemo.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_IMEMO_H                                 /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_IMEMO_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/inits.h
+++ b/internal/inits.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_INITS_H                                 /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_INITS_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/io.h
+++ b/internal/io.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_IO_H                                    /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_IO_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/load.h
+++ b/internal/load.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_LOAD_H                                  /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_LOAD_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/loadpath.h
+++ b/internal/loadpath.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_LOADPATH_H                              /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_LOADPATH_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/math.h
+++ b/internal/math.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_MATH_H                                  /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_MATH_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/missing.h
+++ b/internal/missing.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_MISSING_H                               /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_MISSING_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/numeric.h
+++ b/internal/numeric.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_NUMERIC_H                               /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_NUMERIC_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/object.h
+++ b/internal/object.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_OBJECT_H                                /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_OBJECT_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/parse.h
+++ b/internal/parse.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_PARSE_H                                 /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_PARSE_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/proc.h
+++ b/internal/proc.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_PROC_H                                  /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_PROC_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/process.h
+++ b/internal/process.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_PROCESS_H                               /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_PROCESS_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/random.h
+++ b/internal/random.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_RANDOM_H                                /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_RANDOM_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/range.h
+++ b/internal/range.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_RANGE_H                                  /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_RANGE_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/rational.h
+++ b/internal/rational.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_RATIONAL_H                              /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_RATIONAL_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/re.h
+++ b/internal/re.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_RE_H                                    /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_RE_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/sanitizers.h
+++ b/internal/sanitizers.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_SANITIZERS_H                            /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_SANITIZERS_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/serial.h
+++ b/internal/serial.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_SERIAL_H                                /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_SERIAL_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/signal.h
+++ b/internal/signal.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_SIGNAL_H                                /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_SIGNAL_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/static_assert.h
+++ b/internal/static_assert.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_STATIC_ASSERT_H                         /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_STATIC_ASSERT_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/string.h
+++ b/internal/string.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_STRING_H                                /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_STRING_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/struct.h
+++ b/internal/struct.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_STRUCT_H                                /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_STRUCT_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/symbol.h
+++ b/internal/symbol.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_SYMBOL_H                                /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_SYMBOL_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/thread.h
+++ b/internal/thread.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_THREAD_H                                /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_THREAD_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/time.h
+++ b/internal/time.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_TIME_H                                  /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_TIME_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/transcode.h
+++ b/internal/transcode.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_TRANSCODE_H                             /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_TRANSCODE_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/util.h
+++ b/internal/util.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_UTIL_H                                  /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_UTIL_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/variable.h
+++ b/internal/variable.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_VARIABLE_H                              /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_VARIABLE_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/vm.h
+++ b/internal/vm.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_VM_H                                    /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_VM_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/internal/warnings.h
+++ b/internal/warnings.h
@ -1,7 +1,6 @@
 #ifndef INTERNAL_WARNINGS_H                              /*-*-C-*-vi:se ft=c:*/
 #define INTERNAL_WARNINGS_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/ruby_assert.h
+++ b/ruby_assert.h
@ -1,7 +1,6 @@
 #ifndef RUBY_TOPLEVEL_ASSERT_H                           /*-*-C-*-vi:se ft=c:*/
 #define RUBY_TOPLEVEL_ASSERT_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/variable.h
+++ b/variable.h
@ -1,7 +1,6 @@
 #ifndef RUBY_TOPLEVEL_VARIABLE_H                         /*-*-C-*-vi:se ft=c:*/
 #define RUBY_TOPLEVEL_VARIABLE_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/version.h
+++ b/version.h
@ -1,7 +1,6 @@
 #ifndef RUBY_TOPLEVEL_VERSION_H                          /*-*-C-*-vi:se ft=c:*/
 #define RUBY_TOPLEVEL_VERSION_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or
--- a/vm_callinfo.h
+++ b/vm_callinfo.h
@ -1,7 +1,6 @@
 #ifndef RUBY_VM_CALLINFO_H                               /*-*-C-*-vi:se ft=c:*/
 #define RUBY_VM_CALLINFO_H
 /**
- * @file
 * @author     Ruby developers <ruby-core@ruby-lang.org>
 * @copyright  This  file  is   a  part  of  the   programming  language  Ruby.
 *             Permission  is hereby  granted,  to  either redistribute  and/or