Index: openacs-4/packages/acs-datetime/tcl/acs-calendar-procs.tcl
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-datetime/tcl/acs-calendar-procs.tcl,v
diff -u -r1.31.2.5 -r1.31.2.6
--- openacs-4/packages/acs-datetime/tcl/acs-calendar-procs.tcl	23 Mar 2023 13:13:36 -0000	1.31.2.5
+++ openacs-4/packages/acs-datetime/tcl/acs-calendar-procs.tcl	23 Mar 2023 13:24:44 -0000	1.31.2.6
@@ -356,7 +356,7 @@
     return [concat $output "</tr></table>\n"]
 }
 
-ad_proc dt_widget_calendar_year {
+ad_proc -deprecated dt_widget_calendar_year {
     {-calendar_details ""}
     {-date ""}
     {-days_of_week ""}
@@ -376,6 +376,9 @@
     {-prev_month_template ""}
     {-width 2}
 } {
+    DEPRECATED: this api is never used in upstream code. Having such
+    widgets in the api makes it also difficult to style them.
+
     @return a calendar year of small calendars for the year of the
             passed in date.  Defaults to this year.
 } {
Index: openacs-4/packages/acs-datetime/www/doc/design.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-datetime/www/doc/design.adp,v
diff -u -r1.4.2.3 -r1.4.2.4
--- openacs-4/packages/acs-datetime/www/doc/design.adp	23 Mar 2023 13:17:53 -0000	1.4.2.3
+++ openacs-4/packages/acs-datetime/www/doc/design.adp	23 Mar 2023 13:24:44 -0000	1.4.2.4
@@ -89,10 +89,7 @@
 calendars centered in a given month (previous, current, next)</li><li>
 <code>dt_widget_year</code> generates a yearly calendar
 (composed of small monthly calendars) given the starting month as a
-date</li><li>
-<code>dt_widget_calendar_year</code> generates a yearly
-calendar based on calendar year (Jan to Dec), given any date within
-that calendar year</li>
+date</li>
 </ol>
 <h3>XII. Future Improvements/Areas of Likely Change</h3>
 <p>Many of the calendar widgets generate extensive HTML from within
Index: openacs-4/packages/acs-datetime/www/doc/design.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-datetime/www/doc/design.html,v
diff -u -r1.3.2.2 -r1.3.2.3
--- openacs-4/packages/acs-datetime/www/doc/design.html	23 Mar 2023 13:17:53 -0000	1.3.2.2
+++ openacs-4/packages/acs-datetime/www/doc/design.html	23 Mar 2023 13:24:44 -0000	1.3.2.3
@@ -109,9 +109,6 @@
 centered in a given month (previous, current, next)
 <li><code>dt_widget_year</code> generates a yearly calendar (composed of small monthly calendars)
 given the starting month as a date
-<li><code>dt_widget_calendar_year</code> generates a yearly calendar
-based on calendar year (Jan to Dec), given any date within that
-calendar year
 </ol>
 
 <h3>XII.  Future Improvements/Areas of Likely Change</h3>
Index: openacs-4/packages/acs-datetime/www/doc/examples/calendar-widgets.tcl
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-datetime/www/doc/examples/Attic/calendar-widgets.tcl,v
diff -u -r1.4 -r1.4.2.1
--- openacs-4/packages/acs-datetime/www/doc/examples/calendar-widgets.tcl	7 Aug 2017 23:47:55 -0000	1.4
+++ openacs-4/packages/acs-datetime/www/doc/examples/calendar-widgets.tcl	23 Mar 2023 13:24:44 -0000	1.4.2.1
@@ -19,7 +19,6 @@
     "dt_widget_month_centered"
     "dt_widget_month"
     "dt_widget_year -width 4"
-    "dt_widget_calendar_year -width 4"
 }
 
 # Generate a multirow datasource to transmit the examples to the
Index: openacs-4/packages/acs-datetime/www/doc/examples/index.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-datetime/www/doc/examples/index.adp,v
diff -u -r1.5 -r1.5.2.1
--- openacs-4/packages/acs-datetime/www/doc/examples/index.adp	7 Aug 2017 23:47:55 -0000	1.5
+++ openacs-4/packages/acs-datetime/www/doc/examples/index.adp	23 Mar 2023 13:24:44 -0000	1.5.2.1
@@ -14,7 +14,6 @@
 <li><a href="datetime-procs">Date and time functions</a>
 <li><a href="datetime-widgets">Date and time widgets</a>
 <li><a href="calendar-widgets">Calendar widgets</a>
-<li><a href="calendar-navigation">Calendar navigation widget</a>
 
 </ul>