Docs: Clarify DeviceProperties Items
@@ -1806,12 +1806,13 @@ as they were not constructed at the first stage. See \texttt{SSDT-IMEI.dsl} and
\textbf{Type}: \texttt{plist\ dict}\\
\textbf{Description}: Sets device properties from a map (\texttt{plist\ dict})
of device paths to a map (\texttt{plist\ dict}) of variable names and their values
- in \texttt{plist\ multidata} format. Device paths must be provided in canonic string
- format (e.g. \texttt{PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x0)}). Properties will only
- be set if not present and not deleted.
+ in \texttt{plist\ multidata} format.
- \emph{Note}: Currently properties may only be (formerly) added by the original driver,
- so unless a separate driver was installed, there is no reason to delete the variables.
+ \emph{Note 1}: Device paths must be provided in canonic string format
+ (e.g. \texttt{PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x0)}).
+
+ \emph{Note 2}: Existing properties will not be changed unless deleted
+ in the \texttt{DeviceProperties\ Delete} section.
\item
\texttt{Delete}\\
@@ -1820,6 +1821,10 @@ as they were not constructed at the first stage. See \texttt{SSDT-IMEI.dsl} and
of device paths to an array (\texttt{plist\ array}) of variable names in
\texttt{plist\ string} format.
+ \emph{Note}: Currently, existing properties may only exist on firmware
+ with DeviceProperties drivers (e.g. Apple). Hence, there is typically
+ no reason to delete variables unless a new driver has been installed.
+
\end{enumerate}
\subsection{Common Properties}\label{devpropscommon}
