Improved stateful surpasses() impl that hews closely to the NonISODateSurpasses spec

This is not ready to go, but I wanted to get some feedback.

Most of the following will not make sense until one has seen the code.

- The priority here is to stick to the spec, and avoid recalculation.
  There are some clumsy aspects, like the need for the caller to
  invoke the checker in a specific way:

  1. Large fields to small fields.
  2. Before moving from field A to field B, make a final
     call with the computed value of field A, to set the internal
     state correctly.
  3. Caller maintains their own y/m/w/d.

  I tried to work around unicode-org#2 and unicode-org#3, but couldn't come up with
  anything clean. It seems like the current approach is a good
  compromise.

- For the debug assertions, clippy complained that I was calling
  a mut function. This is actually ok, because the object
  is reset to a new state immediately afterwards. The workaround
  to the clippy warning is expensive, but should be ok because it's
  just for debug. I tried other approaches but didn't get anything
  else to work. Adding an "allow" directive didn't work because
  debug_assert! is a macro.

- There is now no in-library usage of surpasses(). All the testing
  for that was via until() as far as I can tell. The work item is
  to add test coverage for surpasses(), and once that looks good,
  I will refactor surpasses() to use the stateful checker, to
  optimize performance and eliminate duplicate code.

Also included: Minor edits to balance some backticks.

Author: poulsbo

components/calendar/src/cal/east_asian_traditional.rs

@@ -386,7 +386,7 @@ impl KoreanTraditional {
     /// Use [`Self::new`].
     #[cfg(feature = "serde")]
     #[doc = icu_provider::gen_buffer_unstable_docs!(BUFFER,Self::new)]
-    #[deprecated(since = "2.1.0", note = "use `Self::new()")]
+    #[deprecated(since = "2.1.0", note = "use `Self::new()`")]
     pub fn try_new_with_buffer_provider(
         _provider: &(impl BufferProvider + ?Sized),
     ) -> Result<Self, DataError> {
@@ -395,13 +395,13 @@ impl KoreanTraditional {
 
     /// Use [`Self::new`].
     #[doc = icu_provider::gen_buffer_unstable_docs!(UNSTABLE, Self::new)]
-    #[deprecated(since = "2.1.0", note = "use `Self::new()")]
+    #[deprecated(since = "2.1.0", note = "use `Self::new()`")]
     pub fn try_new_unstable<D: ?Sized>(_provider: &D) -> Result<Self, DataError> {
         Ok(Self::new())
     }
 
     /// Use [`Self::new`].
-    #[deprecated(since = "2.1.0", note = "use `Self::new()")]
+    #[deprecated(since = "2.1.0", note = "use `Self::new()`")]
     pub fn new_always_calculating() -> Self {
         Self::new()
     }
@@ -527,21 +527,21 @@ impl ChineseTraditional {
 
     #[cfg(feature = "serde")]
     #[doc = icu_provider::gen_buffer_unstable_docs!(BUFFER,Self::new)]
-    #[deprecated(since = "2.1.0", note = "use `Self::new()")]
+    #[deprecated(since = "2.1.0", note = "use `Self::new()`")]
     pub fn try_new_with_buffer_provider(
         _provider: &(impl BufferProvider + ?Sized),
     ) -> Result<Self, DataError> {
         Ok(Self::new())
     }
 
     #[doc = icu_provider::gen_buffer_unstable_docs!(UNSTABLE, Self::new)]
-    #[deprecated(since = "2.1.0", note = "use `Self::new()")]
+    #[deprecated(since = "2.1.0", note = "use `Self::new()`")]
     pub fn try_new_unstable<D: ?Sized>(_provider: &D) -> Result<Self, DataError> {
         Ok(Self::new())
     }
 
     /// Use [`Self::new()`].
-    #[deprecated(since = "2.1.0", note = "use `Self::new()")]
+    #[deprecated(since = "2.1.0", note = "use `Self::new()`")]
     pub fn new_always_calculating() -> Self {
         Self::new()
     }

components/calendar/src/cal/hijri.rs

@@ -1038,15 +1038,15 @@ impl<A: AsCalendar<Calendar = Hijri<R>>, R: Rules> Date<A> {
 
 impl Date<Hijri<UmmAlQura>> {
     /// Deprecated
-    #[deprecated(since = "2.1.0", note = "use `Date::try_new_hijri_with_calendar")]
+    #[deprecated(since = "2.1.0", note = "use `Date::try_new_hijri_with_calendar`")]
     pub fn try_new_ummalqura(year: i32, month: u8, day: u8) -> Result<Self, RangeError> {
         Date::try_new_hijri_with_calendar(year, month, day, Hijri::new_umm_al_qura())
     }
 }
 
 impl<A: AsCalendar<Calendar = Hijri<TabularAlgorithm>>> Date<A> {
     /// Deprecated
-    #[deprecated(since = "2.1.0", note = "use `Date::try_new_hijri_with_calendar")]
+    #[deprecated(since = "2.1.0", note = "use `Date::try_new_hijri_with_calendar`")]
     pub fn try_new_hijri_tabular_with_calendar(
         year: i32,
         month: u8,