Use `backticks` more uniformly in MachOImage*Reader Doxygen documentation

util/mac/mach_o_image_reader.h

 // Copyright 2014 The Crashpad Authors. All rights reserved.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
 // You may obtain a copy of the License at
 //
 //     http://www.apache.org/licenses/LICENSE-2.0
 //
 // Unless required by applicable law or agreed to in writing, software
 // distributed under the License is distributed on an "AS IS" BASIS,
@@ skipping 58 matching lines @@
   //! This value comes from the `filetype` field of the `mach_header` or
   //! `mach_header_64`. Common values include `MH_EXECUTE`, `MH_DYLIB`,
   //! `MH_DYLINKER`, and `MH_BUNDLE`.
   uint32_t FileType() const { return file_type_; }
 
   //! \brief Returns the Mach-O image’s load address.
   //!
   //! This is the value passed as \a address to Initialize().
   mach_vm_address_t Address() const { return address_; }
 
-  //! \brief Returns the mapped size of the Mach-O image’s __TEXT segment.
+  //! \brief Returns the mapped size of the Mach-O image’s `__TEXT` segment.
   //!
-  //! Note that this is returns only the size of the __TEXT segment, not of any
-  //! other segment. This is because the interface only allows one load address
-  //! and size to be reported, but Mach-O image files may consist of multiple
-  //! discontiguous segments. By convention, the __TEXT segment is always mapped
-  //! at the beginning of a Mach-O image file, and it is the most useful for the
-  //! expected intended purpose of collecting data to obtain stack backtraces.
-  //! The implementation insists during initialization that the __TEXT segment
-  //! be mapped at the beginning of the file.
+  //! Note that this is returns only the size of the `__TEXT` segment, not of
+  //! any other segment. This is because the interface only allows one load
+  //! address and size to be reported, but Mach-O image files may consist of
+  //! multiple discontiguous segments. By convention, the `__TEXT` segment is
+  //! always mapped at the beginning of a Mach-O image file, and it is the most
+  //! useful for the expected intended purpose of collecting data to obtain
+  //! stack backtraces. The implementation insists during initialization that
+  //! the `__TEXT` segment be mapped at the beginning of the file.
   //!
   //! In practice, discontiguous segments are only found for images that have
-  //! loaded out of the dyld shared cache, but the __TEXT segment’s size is
+  //! loaded out of the dyld shared cache, but the `__TEXT` segment’s size is
   //! returned for modules that loaded with contiguous segments as well for
   //! consistency.
   mach_vm_size_t Size() const { return size_; }
 
   //! \brief Returns the Mach-O image’s “slide,” the difference between its
   //!     actual load address and its preferred load address.
   //!
-  //! “Slide” is computed by subtracting the __TEXT segment’s preferred load
+  //! “Slide” is computed by subtracting the `__TEXT` segment’s preferred load
   //! address from its actual load address. It will be reported as a positive
   //! offset when the actual load address is greater than the preferred load
   //! address. The preferred load address is taken to be the segment’s reported
   //! `vmaddr` value.
   mach_vm_size_t Slide() const { return slide_; }
 
   //! \brief Obtain segment information by segment name.
   //!
   //! \param[in] segment_name The name of the segment to search for, for
   //!     example, `"__TEXT"`.

[Robert Sesek, 2014/09/16 21:19:37]

You have "" here and a few other places.

[Mark Mentovai, 2014/09/16 21:29:56]

Where they’re string names, I used "quotes".

   //!
   //! \return A pointer to the segment information if it was found, or `NULL` if
   //!     it was not found. The caller does not take ownership; the lifetime of
   //!     the returned object is scoped to the lifetime of this MachOImageReader
   //!     object.
   const MachOImageSegmentReader* GetSegmentByName(
       const std::string& segment_name) const;
 
   //! \brief Obtain section information by segment and section name.
   //!
@@ skipping 213 matching lines @@
   // set. symbol_table_initialized_ will be valid without symbol_table_ being
   // set in modules that have no symbol table.
   mutable InitializationState symbol_table_initialized_;
 
   DISALLOW_COPY_AND_ASSIGN(MachOImageReader);
 };
 
 }  // namespace crashpad
 
 #endif  // CRASHPAD_UTIL_MAC_MACH_O_IMAGE_READER_H_