Docs: Add errata

Docs/BuildDocs.tool

@@ -35,4 +35,16 @@ latexdiff -s ONLYCHANGEDPAGE PreviousConfiguration.tex ../Configuration.tex \
 pdflatex -draftmode -interaction=nonstopmode Differences
 pdflatex -draftmode -interaction=nonstopmode Differences
 pdflatex -interaction=nonstopmode Differences
+
+cd ../Errata || abort "Unable to process annotations"
+
+rm -f ./*.aux ./*.log ./*.out ./*.pdf ./*.toc
+
+pdflatex -draftmode Errata.tex || \
+  abort "Unable to create errata pdf"
+pdflatex -draftmode Errata.tex || \
+  abort "Unable to create errata pdf with TOC"
+pdflatex Errata.tex || \
+  abort "Unable to create errata pdf with TOC"
+
 exit 0

Docs/Configuration.tex

@@ -117,6 +117,8 @@ operating system. It is to be read as the official clarification of expected
 OpenCore behaviour. All deviations, if found in published OpenCore releases,
 shall be considered documentation or implementation bugs, and are requested to be
 reported through \href{https://github.com/acidanthera/bugtracker}{Acidanthera Bugtracker}.
+Errata sheet is available in
+\href{https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/Errata/Errata.pdf}{OpenCorePkg repository}.
 
 This document is structured as a specification, and is not meant to provide a step by
 step algorithm for configuring end-user board support package (BSP). The intended audience

Docs/Differences/Differences.tex

 \documentclass[]{article}
 %DIF LATEXDIFF DIFFERENCE FILE
-%DIF DEL PreviousConfiguration.tex   Mon Jun  1 20:09:52 2020
-%DIF ADD ../Configuration.tex        Mon Jun  1 20:13:53 2020
+%DIF DEL PreviousConfiguration.tex   Tue Jun  2 03:55:18 2020
+%DIF ADD ../Configuration.tex        Tue Jun  2 08:06:06 2020
 
 \usepackage{lmodern}
 \usepackage{amssymb,amsmath}
@@ -176,7 +176,9 @@ configuration file format used to setup the correct functioning of macOS
 operating system. It is to be read as the official clarification of expected
 OpenCore behaviour. All deviations, if found in published OpenCore releases,
 shall be considered documentation or implementation bugs, and are requested to be
-reported through \href{https://github.com/acidanthera/bugtracker}{Acidanthera Bugtracker}.
+reported through \href{https://github.com/acidanthera/bugtracker}{Acidanthera Bugtracker}\DIFaddbegin \DIFadd{.
+Errata sheet is available in
+}\href{https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/Errata/Errata.pdf}{OpenCorePkg repository}\DIFaddend .
 
 This document is structured as a specification, and is not meant to provide a step by
 step algorithm for configuring end-user board support package (BSP). The intended audience

Docs/Errata/Errata.tex

+\documentclass[]{article}
+
+\usepackage{lmodern}
+\usepackage{amssymb,amsmath}
+\usepackage{ifxetex,ifluatex}
+\usepackage{fixltx2e} % provides \textsubscript
+\usepackage[T1]{fontenc}
+\usepackage[utf8]{inputenc}
+\usepackage{upquote}
+\usepackage{microtype}
+\usepackage[unicode=true]{hyperref}
+\usepackage{longtable,booktabs}
+\usepackage{footnote}
+\usepackage{listings}
+\usepackage{mathtools}
+\usepackage{parskip}
+\usepackage[margin=0.7in]{geometry}
+\usepackage{titlesec}
+\usepackage[yyyymmdd,hhmmss]{datetime}
+\usepackage{textcomp}
+\usepackage{tikz}
+
+\usetikzlibrary{trees}
+\tikzstyle{every node}=[draw=black,thick,anchor=west]
+\tikzstyle{selected}=[draw=blue]
+\tikzstyle{optional}=[dashed,fill=gray!50]
+
+\renewcommand{\dateseparator}{.}
+
+\makeatletter
+\newcommand*{\bdiv}{%
+  \nonscript\mskip-\medmuskip\mkern5mu%
+  \mathbin{\operator@font div}\penalty900\mkern5mu%
+  \nonscript\mskip-\medmuskip
+}
+\makeatother
+
+% Newer LaTeX versions should not add ligatures to listings, but for some reason
+% it is not the case for me. As a result select PDF viewers copy wrong data.
+\lstdefinestyle{ocbash}{
+  language=bash,
+  frame=tb,
+  columns=fullflexible,
+  captionpos=b,
+  basicstyle=\ttfamily\normalsize,
+  keepspaces=true,
+  morekeywords={git, make, build, ioreg, grep, nvram, sort, sudo, diskutil, gfxutil, strings, dd, cut, python},
+  literate =
+    {"}{{\textquotedbl}}1
+    {'}{{\textquotesingle}}1
+    {-}{{-}}1
+    {~}{{\texttildelow}}1
+    {*}{{*}}1
+    {fl}{{f{}l}}2
+    {fi}{{f{}i}}2
+    ,
+}
+
+\UseMicrotypeSet[protrusion]{basicmath} % disable protrusion for tt fonts
+\PassOptionsToPackage{hyphens}{url} % url is loaded by hyperref
+
+\makesavenoteenv{long table} % Fix footnotes in tables
+
+% set default figure placement to htbp
+\makeatletter
+\def\fps@figure{htbp}
+\makeatother
+
+\providecommand{\tightlist}{%
+  \setlength{\itemsep}{0pt}\setlength{\parskip}{0pt}}
+
+\newcommand{\sectionbreak}{\clearpage}
+
+\begin{document}
+
+\begin{titlepage}
+   \begin{center}
+       \vspace*{2.0in}
+
+       \Huge
+
+       \IfFileExists{Logos/Logo.pdf}
+         {\includegraphics[width=160pt, height=160pt]{Logos/Logo.pdf}}
+         {\includegraphics[width=160pt, height=160pt]{../Logos/Logo.pdf}}
+
+       \sffamily
+
+       \textbf{OpenCore}
+
+       \vspace{0.2in}
+
+       Errata Sheet
+
+       \vspace{0.2in}
+
+        {[}\today{]}
+
+       \normalsize
+
+       \vfill
+
+       \rmfamily
+
+       Copyright \textcopyright 2020 vit9696
+
+   \end{center}
+\end{titlepage}
+
+\section{Introduction}\label{introduction}
+
+This document provides information on select issues discovered in the relesed
+versions of \href{https://github.com/acidanthera/OpenCorePkg}{OpenCore}
+and provides workarounds whenever possible. This document is updated
+after OpenCore is released and is thus not contained in the binary packages.
+
+This document contains issues considered causing significant impact on the end-user.
+More details on all known issues including feature requests and development version issues
+can be found at \href{https://github.com/acidanthera/bugtracker}{Acidanthera Bugtracker}.
+
+\section{Issue list}\label{issuelist}
+
+\begin{itemize}
+\item
+  \textbf{Identifier}: \texttt{ERR059-1} \\
+  \textbf{Published}: 2020-06-02 08:06 MSK \\
+  \textbf{Updated}: 2020-06-02 08:06 MSK \\
+  \textbf{Affected versions}: 0.5.9 \\
+  \textbf{Resolved in}: 0.6.0 (\href{https://github.com/acidanthera/OpenCorePkg/commit/9d5aa267a9133fd9390b62012c21428fc77681f2}{9d5aa267}) \\
+  \textbf{Description}:
+
+  Boot picker menu may not show when upgrading macOS with the following error:
+
+\texttt{OCUI: Entry kind 16 unsupported for IconOCB: ShowMenu failed - Unsupported}\\
+\texttt{Halting on critical error}
+
+  \textbf{Possible workarounds}:
+  \begin{itemize}
+    \tightlist
+    \item Enable \texttt{BlacklistAppleUpdate} option \texttt{OR}
+    \item Avoid using OpenCanopy \texttt{OR}
+    \item Disable showing picker by setting \texttt{ShowPicker} to \texttt{false} \texttt{OR}
+    \item Do not perform macOS upgrades.
+  \end{itemize}
+\item
+  \textbf{Identifier}: \texttt{ERR059-2} \\
+  \textbf{Published}: 2020-06-02 08:06 MSK \\
+  \textbf{Updated}: 2020-06-02 08:06 MSK \\
+  \textbf{Affected versions}: 0.5.9 \\
+  \textbf{Resolved in}: \texttt{---} \\
+  \textbf{Description}:
+
+  Incorrect operating system may be selected as the default during macOS upgrade when
+  Windows and macOS are installed on the same disk. Reference:
+  \href{https://github.com/acidanthera/bugtracker/issues/948}{acidanthera/bugtracker\#948}.
+
+  \textbf{Possible workarounds}:
+  \begin{itemize}
+    \tightlist
+    \item Install Windows on a separate disk \texttt{OR}
+    \item Do not perform macOS upgrades \texttt{OR}
+    \item Stay on OpenCore 0.5.8.
+  \end{itemize}
+\end{itemize}
+
+\end{document}