From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 74F8B1382C5 for ; Sat, 24 Feb 2018 12:57:49 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id A1B0DE07F6; Sat, 24 Feb 2018 12:57:48 +0000 (UTC) Received: from smtp.gentoo.org (mail.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 70DF2E07F6 for ; Sat, 24 Feb 2018 12:57:48 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 09F05335C2F for ; Sat, 24 Feb 2018 12:57:47 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 3592B1FE for ; Sat, 24 Feb 2018 12:57:42 +0000 (UTC) From: "Ulrich Müller" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Müller" Message-ID: <1519476192.5267d136c1e9131f550d85eb99275f2579554418.ulm@gentoo> Subject: [gentoo-commits] proj/pms:master commit in: / X-VCS-Repository: proj/pms X-VCS-Files: names.tex pkg-mgr-commands.tex profiles.tex X-VCS-Directories: / X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Müller X-VCS-Revision: 5267d136c1e9131f550d85eb99275f2579554418 X-VCS-Branch: master Date: Sat, 24 Feb 2018 12:57:42 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Archives-Salt: 2726c847-fe3f-42c4-8b4a-e8e4b027b501 X-Archives-Hash: fef3909a10acad3c109a8f475a32a8b4 commit: 5267d136c1e9131f550d85eb99275f2579554418 Author: Ulrich Müller gentoo org> AuthorDate: Sat Feb 24 12:43:12 2018 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Sat Feb 24 12:43:12 2018 +0000 URL: https://gitweb.gentoo.org/proj/pms.git/commit/?id=5267d136 Make letter case more consistent. Write "algorithm", "listing" and "table" in sentence case throughout the document. names.tex | 14 +++++++------- pkg-mgr-commands.tex | 24 ++++++++++++------------ profiles.tex | 4 ++-- 3 files changed, 21 insertions(+), 21 deletions(-) diff --git a/names.tex b/names.tex index d60e97b..be55698 100644 --- a/names.tex +++ b/names.tex @@ -75,7 +75,7 @@ This may optionally be followed by the suffix \t{-r} followed immediately by an \section{Version Comparison} Version specifications are compared component by component, moving from left to right, -as detailed in Algorithm~\ref{alg:version-comparison} and sub-algorithms. +as detailed in algorithm~\ref{alg:version-comparison} and sub-algorithms. If a sub-algorithm returns a decision, then that is the result of the whole comparison; if it terminates without returning a decision, the process continues from the point from which it was invoked. @@ -84,10 +84,10 @@ from which it was invoked. \caption{Version comparison top-level logic} \label{alg:version-comparison} \begin{algorithmic}[1] \STATE let $A$ and $B$ be the versions to be compared - \STATE compare numeric components using Algorithm~\ref{alg:version-comparison-numeric} - \STATE compare letter components using Algorithm~\ref{alg:version-comparison-letter} - \STATE compare suffixes using Algorithm~\ref{alg:version-comparison-suffix} - \STATE compare revision components using Algorithm~\ref{alg:version-comparison-revision} + \STATE compare numeric components using algorithm~\ref{alg:version-comparison-numeric} + \STATE compare letter components using algorithm~\ref{alg:version-comparison-letter} + \STATE compare suffixes using algorithm~\ref{alg:version-comparison-suffix} + \STATE compare revision components using algorithm~\ref{alg:version-comparison-revision} \RETURN $A=B$ \end{algorithmic} \end{algorithm} @@ -105,7 +105,7 @@ from which it was invoked. \STATE let $Ann$ be the number of numeric components of $A$ \STATE let $Bnn$ be the number of numeric components of $B$ \FORALL{$i$ such that $i\geq1$ and $iBnn$} \RETURN $A>B$ @@ -158,7 +158,7 @@ from which it was invoked. \STATE let $Asn$ be the number of suffixes of $A$ \STATE let $Bsn$ be the number of suffixes of $B$ \FORALL{$i$ such that $i\geq0$ and $iBsn$} \IF{$As_{Bsn}$ is of type \t{_p}} diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex index 7883709..07abfbb 100644 --- a/pkg-mgr-commands.tex +++ b/pkg-mgr-commands.tex @@ -165,7 +165,7 @@ Ebuilds must not run any of these commands once the current phase function has r \begin{description} \item[eapply] \featurelabel{eapply} Takes zero or more GNU patch 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}. If applying the patches fails, it aborts the build + according to algorithm~\ref{alg:eapply}. If applying the patches fails, it aborts the build using \t{die}, unless run using \t{nonfatal}, in which case it returns non-zero exit status. Only available in EAPIs listed in table~\ref{tab:patch-commands} as supporting \t{eapply}. @@ -263,7 +263,7 @@ current phase function has returned. \item -{}-host must be the value of the \t{CHOST} environment variable. \item -{}-target must be the value of the \t{CTARGET} environment variable. This option will only be passed if \t{CTARGET} is non-empty. - \item -{}-libdir must be set according to Algorithm~\ref{alg:econf-libdir}. + \item -{}-libdir must be set according to algorithm~\ref{alg:econf-libdir}. \item -{}-disable-dependency-tracking, if the EAPI is listed in table~\ref{tab:econf-options-table} as using it. This option will only be passed if the string \t{-{}-disable-dependency-tracking} occurs in the output of \t{configure -{}-help}. @@ -292,8 +292,8 @@ current phase function has returned. \end{centertable} Note that the \t{\$\{EPREFIX\}} component represents the same offset-prefix as described in - Table~\ref{tab:defined-vars}. It facilitates offset-prefix installations which is supported by - EAPIs listed in Table~\ref{tab:offset-env-vars-table}. When no offset-prefix installation is in + table~\ref{tab:defined-vars}. It facilitates offset-prefix installations which is supported by + EAPIs listed in table~\ref{tab:offset-env-vars-table}. When no offset-prefix installation is in effect, \t{EPREFIX} becomes the empty string, making the behaviour of \t{econf} equal for both offset-prefix supporting and agnostic EAPIs. @@ -327,19 +327,19 @@ current phase function has returned. section~\ref{sec:guaranteed-system-commands}. \t{emake} must be an external program and cannot be a function or alias---it must be callable from e.\,g.\ \t{xargs}. Failure behaviour is EAPI dependent as per section~\ref{sec:failure-behaviour}. -\item[einstall] A shortcut for the command given in Listing~\ref{lst:einstall}. Any arguments given +\item[einstall] A shortcut for the command given in listing~\ref{lst:einstall}. Any arguments given to \t{einstall} are passed verbatim to \t{emake}, as shown. Failure behaviour is EAPI dependent as per section~\ref{sec:failure-behaviour}. In EAPIs listed in table~\ref{tab:banned-commands-table}, this command is banned as per section~\ref{sec:banned-commands}. - The variable \t{ED} is defined as in Table~\ref{tab:defined-vars} and depends on the use of an + The variable \t{ED} is defined as in table~\ref{tab:defined-vars} and depends on the use of an offset-prefix. When such offset-prefix is absent, \t{ED} is equivalent to \t{D}\@. \t{ED} is always available in EAPIs that support offset-prefix installations as listed in - Table~\ref{tab:offset-env-vars-table}, hence EAPIs lacking offset-prefix support should use - \t{D} instead of \t{ED} in the command given in Listing~\ref{lst:einstall}. + table~\ref{tab:offset-env-vars-table}, hence EAPIs lacking offset-prefix support should use + \t{D} instead of \t{ED} in the command given in listing~\ref{lst:einstall}. Variable \t{libdir} is an auxiliary local variable whose value is determined by - Algorithm~\ref{alg:ebuild-libdir}. + algorithm~\ref{alg:ebuild-libdir}. \begin{listing}[H] \caption{\t{einstall} command} \label{lst:einstall} @@ -457,7 +457,7 @@ can be extended or reduced (see below). The options that can be passed to \t{doh section~\ref{sec:failure-behaviour}. \item[dolib] For each argument, installs it into the appropriate library subdirectory under - \t{DESTTREE}, as determined by Algorithm~\ref{alg:ebuild-libdir}. Files are installed by default + \t{DESTTREE}, as determined by algorithm~\ref{alg:ebuild-libdir}. Files are installed by default with file mode \t{0644}, or with the \t{install} options set by the most recent \t{libopts} call. Any symlinks are installed into the same directory as relative links to their original target. Failure behaviour is EAPI dependent as per section~\ref{sec:failure-behaviour}. @@ -927,7 +927,7 @@ has returned. \item[einstalldocs] \featurelabel{einstalldocs} Takes no arguments. Installs the files specified by the \t{DOCS} and \t{HTML_DOCS} variables or a default set of files, according to - Algorithm~\ref{alg:einstalldocs}. If called using \t{nonfatal} and any of the called commands + algorithm~\ref{alg:einstalldocs}. If called using \t{nonfatal} and any of the called commands returns a non-zero exit status, returns immediately with the same exit status. Only available in EAPIs listed in table~\ref{tab:misc-commands} as supporting \t{einstalldocs}. @@ -960,7 +960,7 @@ has returned. \end{algorithm} \item[get_libdir] \featurelabel{get-libdir} Prints the libdir name obtained according to - Algorithm~\ref{alg:get-libdir}. Only available in EAPIs listed in table~\ref{tab:misc-commands} + algorithm~\ref{alg:get-libdir}. Only available in EAPIs listed in table~\ref{tab:misc-commands} as supporting \t{get_libdir}. \begin{algorithm} diff --git a/profiles.tex b/profiles.tex index 88fc397..7299350 100644 --- a/profiles.tex +++ b/profiles.tex @@ -140,7 +140,7 @@ stable in a package. The precise manner in which the eight files interact is less simple, and is best described in terms of the algorithm used to determine whether a flag is masked for a given package version. This is -described in Algorithm~\ref{alg:use-masking}. +described in algorithm~\ref{alg:use-masking}. \begin{algorithm} \caption{\t{USE} masking logic} \label{alg:use-masking} \begin{algorithmic}[1] @@ -178,7 +178,7 @@ described in Algorithm~\ref{alg:use-masking}. \end{algorithmic} \end{algorithm} -Stable restrictions (``stable keyword in use'' in Algorithm~\ref{alg:use-masking}) are applied +Stable restrictions (``stable keyword in use'' in algorithm~\ref{alg:use-masking}) are applied exactly if replacing in \t{KEYWORDS} all stable keywords by the corresponding tilde prefixed keywords (see subsection~\ref{sec:keywords}) would result in the package installation being prevented due to the \t{KEYWORDS} setting.