--- a/libgui/src/m-editor/file-editor-tab.cc	Wed Sep 27 15:56:39 2017 -0400
+++ b/libgui/src/m-editor/file-editor-tab.cc	Thu Sep 28 10:49:39 2017 +0200
@@ -20,10 +20,9 @@
 
 */
 
-/**
- @file A single GUI file tab.
- This interfaces QsciScintilla with the rest of Octave.
- */
+//! @file A single GUI file tab.
+//!
+//! This interfaces QsciScintilla with the rest of Octave.
 
 #if defined (HAVE_CONFIG_H)
 #  include "config.h"
@@ -84,14 +83,13 @@
 
 bool file_editor_tab::_cancelled = false;
 
-/**
- A file_editor_tab object consists of a text area and three left margins.
- The first holds breakpoints, bookmarks, and the debug program counter.
- The second holds line numbers.
- The third holds "fold" marks, to hide sections of text.
- */
-// Make parent null for the file editor tab so that warning
-// WindowModal messages don't affect grandparents.
+//! A file_editor_tab object consists of a text area and three left margins.
+//! The first holds breakpoints, bookmarks, and the debug program counter.
+//! The second holds line numbers.  The third holds "fold" marks, to hide
+//! sections of text.
+
+// Make parent null for the file editor tab so that warning WindowModal
+// messages don't affect grandparents.
 file_editor_tab::file_editor_tab (const QString& directory_arg)
 {
   _lexer_apis = nullptr;