diff --git a/Documentation/DocBook/media/dvb/frontend_legacy_api.xml b/Documentation/DocBook/media/dvb/frontend_legacy_api.xml
index e2817f830312e47a449c7cea0fbba9d1ec367918..1eedc4ce0e4a500951c8e5d1eaad1a5ad51930f5 100644
--- a/Documentation/DocBook/media/dvb/frontend_legacy_api.xml
+++ b/Documentation/DocBook/media/dvb/frontend_legacy_api.xml
@@ -45,9 +45,19 @@
supported via the new FE_GET_PROPERTY/FE_GET_SET_PROPERTY ioctl's, using the DTV_DELIVERY_SYSTEM parameter.
-The usage of this field is deprecated, as it doesn't report all supported standards, and
-will provide an incomplete information for frontends that support multiple delivery systems.
-Please use DTV_ENUM_DELSYS instead.
+In the old days, &dvb-frontend-info; used to contain
+ fe_type_t field to indicate the delivery systems,
+ filled with either FE_QPSK, FE_QAM, FE_OFDM or FE_ATSC. While this is
+ still filled to keep backward compatibility, the usage of this
+ field is deprecated, as it can report just one delivery system, but some
+ devices support multiple delivery systems. Please use
+ DTV_ENUM_DELSYS instead.
+
+On devices that support multiple delivery systems,
+ &dvb-frontend-info;::fe_type_t is filled with the
+ currently standard, as selected by the last call to
+ FE_SET_PROPERTY
+ using the &DTV-DELIVERY-SYSTEM; property.