Fix the doc comment issues in semconv

Author: zurex

api/include/opentelemetry/semconv/incubating/url_attributes.h

@@ -23,8 +23,8 @@ namespace url
  * Domain extracted from the @code url.full @endcode, such as "opentelemetry.io".
  * <p>
  * In some cases a URL may refer to an IP and/or port directly, without a domain name. In this case,
- * the IP address would go to the domain field. If the URL contains a <a
- * href="https://www.rfc-editor.org/rfc/rfc2732#section-2">literal IPv6 address</a> enclosed by
+ * the IP address would go to the domain field. If the URL contains a 
+ * <a href="https://www.rfc-editor.org/rfc/rfc2732#section-2">literal IPv6 address</a> enclosed by
  * @code [ @endcode and @code ] @endcode, the @code [ @endcode and @code ] @endcode characters
  * should also be captured in the domain field.
  */
@@ -45,8 +45,8 @@ static constexpr const char *kUrlExtension = "url.extension";
 static constexpr const char *kUrlFragment = "url.fragment";
 
 /**
- * Absolute URL describing a network resource according to <a
- * href="https://www.rfc-editor.org/rfc/rfc3986">RFC3986</a> <p> For network calls, URL usually has
+ * Absolute URL describing a network resource according to 
+ * <a href="https://www.rfc-editor.org/rfc/rfc3986">RFC3986</a> <p> For network calls, URL usually has
  * @code scheme://host[:port][path][?query][#fragment] @endcode format, where the fragment is not
  * transmitted over HTTP, but if it is known, it SHOULD be included nevertheless. <p>
  * @code url.full @endcode MUST NOT contain credentials passed via URL in form of @code
@@ -60,15 +60,12 @@ static constexpr const char *kUrlFragment = "url.fragment";
  * Query string values for the following keys SHOULD be redacted by default and replaced by the
  * value @code REDACTED @endcode:
  * <ul>
- *   <li><a
- * href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth">@code
- * AWSAccessKeyId @endcode</a></li> <li><a
- * href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth">@code
- * Signature @endcode</a></li> <li><a
- * href="https://learn.microsoft.com/azure/storage/common/storage-sas-overview#sas-token">@code sig
- * @endcode</a></li> <li><a
- * href="https://cloud.google.com/storage/docs/access-control/signed-urls">@code X-Goog-Signature
- * @endcode</a></li>
+ *   <li>
+ * <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth"> @code AWSAccessKeyId @endcode</a>
+ * </li> <li>
+ * <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth"> @code Signature @endcode</a>
+ * </li> <li><a href="https://learn.microsoft.com/azure/storage/common/storage-sas-overview#sas-token"> @code sig @endcode</a>
+ * </li> <li><a href="https://cloud.google.com/storage/docs/access-control/signed-urls">@code X-Goog-Signature @endcode</a></li>
  * </ul>
  * <p>
  * This list is subject to change over time.
@@ -110,15 +107,11 @@ static constexpr const char *kUrlPort = "url.port";
  * can identify it. <p>
  *
  * Query string values for the following keys SHOULD be redacted by default and replaced by the
- * value @code REDACTED @endcode: <ul> <li><a
- * href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth">@code
- * AWSAccessKeyId @endcode</a></li> <li><a
- * href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth">@code
- * Signature @endcode</a></li> <li><a
- * href="https://learn.microsoft.com/azure/storage/common/storage-sas-overview#sas-token">@code sig
- * @endcode</a></li> <li><a
- * href="https://cloud.google.com/storage/docs/access-control/signed-urls">@code X-Goog-Signature
- * @endcode</a></li>
+ * value @code REDACTED @endcode: <ul> <li>
+ * <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth"> @code AWSAccessKeyId @endcode</a></li> 
+ * <li><a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth"> @code Signature @endcode</a></li> 
+ * <li><a href="https://learn.microsoft.com/azure/storage/common/storage-sas-overview#sas-token"> @code sig @endcode</a></li> 
+ * <li><a href="https://cloud.google.com/storage/docs/access-control/signed-urls">@code X-Goog-Signature @endcode</a></li>
  * </ul>
  * <p>
  * This list is subject to change over time.
@@ -131,8 +124,9 @@ static constexpr const char *kUrlQuery = "url.query";
 /**
  * The highest registered url domain, stripped of the subdomain.
  * <p>
- * This value can be determined precisely with the <a href="https://publicsuffix.org/">public suffix
- * list</a>. For example, the registered domain for @code foo.example.com @endcode is @code
+ * This value can be determined precisely with the 
+ * <a href="https://publicsuffix.org/">public suffix list</a>. 
+ * For example, the registered domain for @code foo.example.com @endcode is @code
  * example.com @endcode. Trying to approximate this by simply taking the last two labels will not
  * work well for TLDs such as @code co.uk @endcode.
  */
@@ -155,16 +149,16 @@ static constexpr const char *kUrlScheme = "url.scheme";
 static constexpr const char *kUrlSubdomain = "url.subdomain";
 
 /**
- * The low-cardinality template of an <a
- * href="https://www.rfc-editor.org/rfc/rfc3986#section-4.2">absolute path reference</a>.
+ * The low-cardinality template of an 
+ * <a href="https://www.rfc-editor.org/rfc/rfc3986#section-4.2">absolute path reference</a>.
  */
 static constexpr const char *kUrlTemplate = "url.template";
 
 /**
  * The effective top level domain (eTLD), also known as the domain suffix, is the last part of the
  * domain name. For example, the top level domain for example.com is @code com @endcode. <p> This
- * value can be determined precisely with the <a href="https://publicsuffix.org/">public suffix
- * list</a>.
+ * value can be determined precisely with the 
+ * <a href="https://publicsuffix.org/">public suffix list</a>.
  */
 static constexpr const char *kUrlTopLevelDomain = "url.top_level_domain";