Use /// for docstrings

src/compact1/character_set.rs

@@ -36,7 +36,7 @@ pub struct CharacterSet2 {
 }
 
 table! {
-    #[doc = "A range of a character set in format 1."]
+    /// A range of a character set in format 1.
     #[derive(Copy)]
     pub Range1 {
         first_string_id (StringID), // first
@@ -45,7 +45,7 @@ table! {
 }
 
 table! {
-    #[doc = "A range of a character set in format 2."]
+    /// A range of a character set in format 2.
     #[derive(Copy)]
     pub Range2 {
         first_string_id (StringID), // first

src/compact1/encoding.rs

@@ -14,7 +14,7 @@ pub enum Encoding {
 }
 
 table! {
-    #[doc = "An encoding in format 0."]
+    /// An encoding in format 0.
     pub Encoding0 { // Format 0
         format     (u8) = { 0 }, // format
         code_count (u8), // nCodes
@@ -26,7 +26,7 @@ table! {
 }
 
 table! {
-    #[doc = "An encoding in format 1."]
+    /// An encoding in format 1.
     pub Encoding1 { // Format 1
         format      (u8) = { 1 }, // format
         range_count (u8), // nRanges
@@ -38,7 +38,7 @@ table! {
 }
 
 table! {
-    #[doc = "An encoding in the supplemental format."]
+    /// An encoding in the supplemental format.
     pub EncodingSupplemental { // Supplemental Encoding Data
         format           (u8),
         supplement_count (u8), // nSups
@@ -50,7 +50,7 @@ table! {
 }
 
 table! {
-    #[doc = "A range of an encoding in format 1."]
+    /// A range of an encoding in format 1.
     #[derive(Copy)]
     pub Range1 {
         first_code (u8), // first
@@ -59,7 +59,7 @@ table! {
 }
 
 table! {
-    #[doc = "A supplement of an encoding in the supplemental format."]
+    /// A supplement of an encoding in the supplemental format.
     #[derive(Copy)]
     pub Supplement {
         code  (u8      ), // code

src/compact1/font_set/character_id_keyed.rs

@@ -41,7 +41,7 @@ pub struct Encoding0 {
 }
 
 table! {
-    #[doc = "A glyph-to-dictionary encoding in format 3."]
+    /// A glyph-to-dictionary encoding in format 3.
     pub Encoding3 {
         format      (u8 ) = { 3 }, // format
         range_count (u16), // nRanges
@@ -55,7 +55,7 @@ table! {
 }
 
 table! {
-    #[doc = "A range of a glyph-to-dictionary encoding in format 3."]
+    /// A range of a glyph-to-dictionary encoding in format 3.
     #[derive(Copy)]
     pub Range3 {
         first_glyph_id (GlyphID), // first

src/compact1/header.rs

@@ -1,7 +1,7 @@
 use crate::compact1::OffsetSize;
 
 table! {
-    #[doc = "A header."]
+    /// A header.
     #[derive(Copy)]
     pub Header {
         major       (u8        ), // major

src/compact1/index/character_strings.rs

@@ -2,7 +2,7 @@ use crate::Result;
 
 index! {
     @define
-    #[doc = "A character-string index."]
+    /// A character-string index.
     pub CharacterStrings
 }
 

src/compact1/index/dictionaries.rs

@@ -5,7 +5,7 @@ use crate::tape::Read;
 use crate::{Error, Result};
 
 index! {
-    #[doc = "A dictionary index."]
+    /// A dictionary index.
     pub Dictionaries
 }
 

src/compact1/index/mod.rs

@@ -5,7 +5,7 @@ use crate::Result;
 
 table! {
     @define
-    #[doc = "An index."]
+    /// An index.
     pub Index {
         count       (u16         ), // count
         offset_size (OffsetSize  ), // offSize

src/compact1/index/names.rs

@@ -2,7 +2,7 @@ use crate::compact1::index::Index;
 use crate::{Error, Result};
 
 index! {
-    #[doc = "A name index."]
+    /// A name index.
     pub Names
 }
 

src/compact1/index/strings.rs

@@ -3,7 +3,7 @@ use crate::compact1::StringID;
 const NUMBER_OF_STANDARD_STRINGS: usize = 391;
 
 index! {
-    #[doc = "A string index."]
+    /// A string index.
     pub Strings
 }
 

src/compact1/index/subroutines.rs

@@ -1,5 +1,5 @@
 index! {
-    #[doc = "A subroutine index."]
+    /// A subroutine index.
     #[derive(Default)]
     pub Subroutines
 }