提交 f95c0091 编写于 作者: V vit9696

Docs: Improve the documentation

上级 ee30d2f5
...@@ -131,7 +131,7 @@ Third-party articles, utilities, books, and alike may be more useful for a wider ...@@ -131,7 +131,7 @@ Third-party articles, utilities, books, and alike may be more useful for a wider
they could provide guide-like material. However, they are prone to their authors' preferences, they could provide guide-like material. However, they are prone to their authors' preferences,
tastes, this document misinterpretation, and essential obsolescence. tastes, this document misinterpretation, and essential obsolescence.
In case you use these sources, for example, \href{https://dortania.github.io}{Dortania}'s In case you use these sources, for example, \href{https://dortania.github.io}{Dortania}'s
\href{https://dortania.github.io/OpenCore-Desktop-Guide}{OpenCore Desktop Guide} \href{https://dortania.github.io/OpenCore-Install-Guide}{OpenCore Install Guide}
and \href{https://dortania.github.io/getting-started}{related material}, and \href{https://dortania.github.io/getting-started}{related material},
please ensure to follow this document for every made decision and judge its consequences. please ensure to follow this document for every made decision and judge its consequences.
...@@ -1285,7 +1285,11 @@ To view their current state use \texttt{pmset -g} command in Terminal. ...@@ -1285,7 +1285,11 @@ To view their current state use \texttt{pmset -g} command in Terminal.
support on many firmwares using SMM backing for select services like variable support on many firmwares using SMM backing for select services like variable
storage. SMM may try to access physical addresses, but they get moved by boot.efi. storage. SMM may try to access physical addresses, but they get moved by boot.efi.
\emph{Note}: Most but Apple and VMware firmwares need this quirk. \emph{Note}: Most but Apple and VMware firmwares need this quirk. This quirk
is generally unnecessary when using \texttt{OpenDuetPkg}, but may be required
to boot macOS 10.6 and earlier for unclear reasons.
% The reasons are unclear here.
\item \item
\texttt{DevirtualiseMmio}\\ \texttt{DevirtualiseMmio}\\
...@@ -1658,6 +1662,13 @@ blocking. ...@@ -1658,6 +1662,13 @@ blocking.
order follows the item order in the array, thus the dependencies should be written order follows the item order in the array, thus the dependencies should be written
prior to their consumers. prior to their consumers.
To track the dependency order one can inspect the \texttt{OSBundleLibraries} key
in the \texttt{Info.plist} of the kext. Any kext mentioned in the
\texttt{OSBundleLibraries} of the other kext must be precede this kext.
\emph{Note}: Kexts may have inner kexts (\texttt{Plug-Ins}) in their bundle. Each
inner kext must be added separately.
\item \item
\texttt{Block}\\ \texttt{Block}\\
\textbf{Type}: \texttt{plist\ array}\\ \textbf{Type}: \texttt{plist\ array}\\
......
\documentclass[]{article} \documentclass[]{article}
%DIF LATEXDIFF DIFFERENCE FILE %DIF LATEXDIFF DIFFERENCE FILE
%DIF DEL PreviousConfiguration.tex Fri Jul 17 03:06:36 2020 %DIF DEL PreviousConfiguration.tex Tue Jun 2 03:55:18 2020
%DIF ADD ../Configuration.tex Fri Jul 17 03:06:36 2020 %DIF ADD ../Configuration.tex Sat Jul 25 18:04:52 2020
\usepackage{lmodern} \usepackage{lmodern}
\usepackage{amssymb,amsmath} \usepackage{amssymb,amsmath}
...@@ -192,8 +192,10 @@ Third-party articles, utilities, books, and alike may be more useful for a wider ...@@ -192,8 +192,10 @@ Third-party articles, utilities, books, and alike may be more useful for a wider
they could provide guide-like material. However, they are prone to their authors' preferences, they could provide guide-like material. However, they are prone to their authors' preferences,
tastes, this document misinterpretation, and essential obsolescence. tastes, this document misinterpretation, and essential obsolescence.
In case you use these sources, for example, \href{https://dortania.github.io}{Dortania}'s In case you use these sources, for example, \href{https://dortania.github.io}{Dortania}'s
\href{https://dortania.github.io/OpenCore-Desktop-Guide}{OpenCore Desktop Guide} \DIFdelbegin %DIFDELCMD < \href{https://dortania.github.io/OpenCore-Desktop-Guide}{OpenCore Desktop Guide}
and \href{https://dortania.github.io/getting-started}{related material}, %DIFDELCMD < %%%
\DIFdelend \DIFaddbegin \href{https://dortania.github.io/OpenCore-Install-Guide}{OpenCore Install Guide}
\DIFaddend and \href{https://dortania.github.io/getting-started}{related material},
please ensure to follow this document for every made decision and judge its consequences. please ensure to follow this document for every made decision and judge its consequences.
Be warned that regardless of the sources used you are required to fully understand every Be warned that regardless of the sources used you are required to fully understand every
...@@ -1349,9 +1351,15 @@ To view their current state use \texttt{pmset -g} command in Terminal. ...@@ -1349,9 +1351,15 @@ To view their current state use \texttt{pmset -g} command in Terminal.
support on many firmwares using SMM backing for select services like variable support on many firmwares using SMM backing for select services like variable
storage. SMM may try to access physical addresses, but they get moved by boot.efi. storage. SMM may try to access physical addresses, but they get moved by boot.efi.
\emph{Note}: Most but Apple and VMware firmwares need this quirk. \emph{Note}: Most but Apple and VMware firmwares need this quirk. \DIFaddbegin \DIFadd{This quirk
is generally unnecessary when using }\texttt{\DIFadd{OpenDuetPkg}}\DIFadd{, but may be required
to boot macOS 10.6 and earlier for unclear reasons.
}\DIFaddend
\item %DIF > The reasons are unclear here.
\DIFaddbegin
\DIFaddend \item
\texttt{DevirtualiseMmio}\\ \texttt{DevirtualiseMmio}\\
\textbf{Type}: \texttt{plist\ boolean}\\ \textbf{Type}: \texttt{plist\ boolean}\\
\textbf{Failsafe}: \texttt{false}\\ \textbf{Failsafe}: \texttt{false}\\
...@@ -1726,7 +1734,16 @@ blocking. ...@@ -1726,7 +1734,16 @@ blocking.
order follows the item order in the array, thus the dependencies should be written order follows the item order in the array, thus the dependencies should be written
prior to their consumers. prior to their consumers.
\item \DIFaddbegin \DIFadd{To track the dependency order one can inspect the }\texttt{\DIFadd{OSBundleLibraries}} \DIFadd{key
in the }\texttt{\DIFadd{Info.plist}} \DIFadd{of the kext. Any kext mentioned in the
}\texttt{\DIFadd{OSBundleLibraries}} \DIFadd{of the other kext must be precede this kext.
}
\emph{\DIFadd{Note}}\DIFadd{: Kexts may have inner kexts (}\texttt{\DIFadd{Plug-Ins}}\DIFadd{) in their bundle. Each
inner kext must be added separately.
}
\DIFaddend \item
\texttt{Block}\\ \texttt{Block}\\
\textbf{Type}: \texttt{plist\ array}\\ \textbf{Type}: \texttt{plist\ array}\\
\textbf{Failsafe}: Empty\\ \textbf{Failsafe}: Empty\\
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册