[doc][nfc] Avoid Doxygen documentation errors without disturbing transient I/O mark

Author: ferdymercury

documentation/primer/macros/MySelector.h

@@ -17,7 +17,7 @@
 
 class MySelector : public TSelector {
 public :
-   TTree          *fChain;   //!pointer to the analyzed TTree or TChain
+   TTree          *fChain;   ///<!pointer to the analyzed TTree or TChain
 
 // Fixed size dimensions of array or collections stored in the TTree if any.
 
@@ -28,10 +28,10 @@ public :
    Float_t         Pressure;
 
    // List of branches
-   TBranch        *b_Potential;   //!
-   TBranch        *b_Current;   //!
-   TBranch        *b_Temperature;   //!
-   TBranch        *b_Pressure;   //!
+   TBranch        *b_Potential;   ///<!
+   TBranch        *b_Current;   ///<!
+   TBranch        *b_Temperature;   ///<!
+   TBranch        *b_Pressure;   ///<!
 
    MySelector(TTree * /*tree*/ =0) : fChain(0) { }
    virtual ~MySelector() { }

documentation/users-guide/AddingaClass.md

@@ -602,7 +602,7 @@ class SClass : public TObject {
    private:
       Float_t   fX;         //x position in centimeters
       Float_t   fY;         //y position in centimeters
-      Int_t     fTempValue; //! temporary state value
+      Int_t     fTempValue; ///<! temporary state value
    public:
       SClass()             { fX = fY = -1; }
       void Print() const;
@@ -637,7 +637,7 @@ Interpreter". The `ShowMembers` and `Streamer` method, as well as the
 add a `!` as the first character in the comments of the field:
 
 ``` {.cpp}
-Int_t     fTempValue; //! temporary state value
+Int_t     fTempValue; ///<! temporary state value
 ```
 
 ### The LinkDef.h File

documentation/users-guide/InputOutput.md

@@ -1188,8 +1188,8 @@ simple example of a class with diverse data members.
 ``` {.cpp}
 class Event : public TObject {
 private:
-   TDirectory    *fTransient;            //! current directory
-   Float_t     fPt;                   //! transient value
+   TDirectory    *fTransient;            ///<! current directory
+   Float_t     fPt;                   ///<! transient value
 char           fType[20];
 Int_t          fNtrack;
 Int_t          fNseg;
@@ -1234,7 +1234,7 @@ and its contents into the buffer `R__b`. The `Streamer `calls
 method reads the information from buffer `R__b` into the `Event`
 object.
 
-### Transient Data Members (//!)
+### Transient Data Members (///<!)
 
 
 To prevent a data member from being written to the file, insert a "`!`"
@@ -1246,8 +1246,8 @@ not persistent.
 ``` {.cpp}
 class Event : public TObject {
 private:
-   TDirectory    *fTransient; //! current directory
-   Float_t fPt;               //! transient value
+   TDirectory    *fTransient; ///<! current directory
+   Float_t fPt;               ///<! transient value
 ...
 ```
 
@@ -1895,7 +1895,7 @@ a "`!`" after the comment marks. For example the pointer \*`fPainter` of
 a **`TH1`** is not persistent:
 
 ``` {.cpp}
-   TVirtualHistPainter* fPainter //!pointer to histogram painter
+   TVirtualHistPainter* fPainter ///<!pointer to histogram painter
 ```
 
 ### The TStreamerElement Class