add back WS_Front() as deprecated for now

bin/varnishd/cache/cache.h

@@ -800,6 +800,15 @@ void WS_Id(const struct ws *ws, char *id);
 void WS_VSB_new(struct vsb *, struct ws *);
 char *WS_VSB_finish(struct vsb *, struct ws *, size_t *);
 
+/* REL_20210315 remove */
+static inline char* WS_Front(const struct ws *) v_deprecated_;
+static inline char*
+WS_Front(const struct ws *ws)
+{
+	AN(ws->r);
+	return ws->f;
+}
+
 static inline void *
 WS_Reservation(const struct ws *ws)
 {

doc/changes.rst

@@ -195,12 +195,14 @@ NEXT (scheduled 2020-09-15)
   and ``varnishstat`` for inclusion, exclusion and required glob
   patterns on the statistic field names. (3394_)
 
-* [API] overhaul of the workspace API
+* Overhaul of the workspace API
 
   * The previously deprecated ``WS_Reserve()`` has been removed
-  * The signature of ``WS_Printf()`` has been changed
+  * The signature of ``WS_Printf()`` has been changed to return
+    ``const char *`` instead of ``void *`` (we do not consider this a
+    breaking change).
   * Add ``WS_ReservationSize()``
-  * ``WS_Front()`` replaced by ``WS_Reservation()``
+  * ``WS_Front()`` is now deprecated and replaced by ``WS_Reservation()``
   * Add ``WS_Id()``
 
 * Handle a workspace overflow in ``VRY_Validate()`` (3319_)

include/vrt.h

@@ -58,7 +58,8 @@
  *	[cache.h] WS_Reserve() removed
  *	[cache.h] WS_Printf() changed
  *	[cache.h] WS_ReservationSize() added
- *	[cache.h] WS_Front() replaced by WS_Reservation()
+ *	[cache.h] WS_Front() deprecated
+ *	[cache.h] WS_Reservation() added
  *	[cache.h] WS_Id() added
  * 11.0 (2020-03-16)
  *	Changed type of vsa_suckaddr_len from int to size_t