[gentoo-pms] [PATCH] Explain eapply behavior for EAPI 6

[Michał Górny]

---
 pkg-mgr-commands.tex | 32 ++++++++++++++++++++++++++++----
 1 file changed, 28 insertions(+), 4 deletions(-)

// I'm aware this isn't perfect but I tried to keep the algorithm
// readable and reasonably concise. Hope it's good enough for a start
// though.

diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex
index dbdbdfd..1d57d63 100644
--- a/pkg-mgr-commands.tex
+++ b/pkg-mgr-commands.tex
@@ -148,10 +148,12 @@ These commands are used during the \t{src\_prepare} phase to apply patches to th
 Ebuilds must not run any of these commands once the current phase function has returned.
 
 \begin{description}
-\item[eapply] \featurelabel{eapply}
-    Only available in EAPIs listed in table~\ref{tab:patch-commands} as supporting \t{eapply}.
+\item[eapply] \featurelabel{eapply} Takes zero or more patch(1) options, followed by one or more
+	file or directory paths. Processes options and applies all patches found in specified locations
+	according to Algorithm~\ref{alg:eapply}. Only available in EAPIs listed in
+	table~\ref{tab:patch-commands} as supporting \t{eapply}.
 
-\item[eapply\_user] \featurelabel{eapply-user} Takes no arguments. Package managers supporting it
+\item[eapply\_user] \featurelabel{eapply-user} Takes no arguments. Package managers supporting i
     apply user-provided patches to the source tree in the current working directory. Exact behaviour
     is implementation defined and beyond the scope of this specification. Package managers not
     supporting it must implement the function as a no-op. Only available in EAPIs listed in
@@ -161,7 +163,29 @@ Ebuilds must not run any of these commands once the current phase function has r
 \begin{algorithm}
 \caption{eapply logic} \label{alg:eapply}
 \begin{algorithmic}[1]
-\STATE \COMMENT{WORK IN PROGRESS}
+\STATE let options=()
+\STATE let infiles=FALSE
+\FOR{\$x in parameters}
+	\IF{infiles is FALSE}
+		\IF{\$x is "\t{-{}-}"}
+			\STATE let infiles=TRUE
+		\ELSIF{\$x starts with "\t{-}"}
+			\STATE options+=( "\$x" )
+		\ELSE
+			\STATE let infiles=TRUE
+		\ENDIF
+	\ENDIF
+
+	\IF{infiles is TRUE}
+		\IF{\$x is a directory}
+			\FOR{\$f in all files matching \$x/*.diff and \$x/*.patch}
+				\STATE call \t{patch -p1 -f -s "\$\{options[@]\}" "\$f"}
+			\ENDFOR
+		\ELSE
+			\STATE call \t{patch -p1 -f -s "\$\{options[@]\}" "\$x"}
+		\ENDIF
+	\ENDIF
+\ENDFOR
 \end{algorithmic}
 \end{algorithm}
 
-- 
2.6.1