diff options
-rw-r--r-- | ebuild-writing/common-mistakes/text.xml | 2 | ||||
-rw-r--r-- | ebuild-writing/eapi/text.xml | 2 | ||||
-rw-r--r-- | ebuild-writing/messages/text.xml | 5 | ||||
-rw-r--r-- | function-reference/query-functions/text.xml | 2 | ||||
-rw-r--r-- | general-concepts/dependencies/text.xml | 2 | ||||
-rw-r--r-- | quickstart/text.xml | 2 | ||||
-rw-r--r-- | tasks-reference/pam/text.xml | 18 | ||||
-rw-r--r-- | tools-reference/echo/text.xml | 17 | ||||
-rw-r--r-- | tools-reference/find/text.xml | 2 | ||||
-rw-r--r-- | tools-reference/grep/text.xml | 5 |
10 files changed, 27 insertions, 30 deletions
diff --git a/ebuild-writing/common-mistakes/text.xml b/ebuild-writing/common-mistakes/text.xml index e39e2e6..0b6adb8 100644 --- a/ebuild-writing/common-mistakes/text.xml +++ b/ebuild-writing/common-mistakes/text.xml @@ -263,7 +263,7 @@ bug about that ebuild. <p> You should try not to include version numbers in the SRC_URI and S. Always try to use ${PV} or ${P}. It makes maintaining the ebuild much easier. If a version -number is not consistent with the tarball/source, then use MY_P. An example +number is not consistent with the tarball/source, then use MY_P. For example dev-python/pyopenal fetches a tarball called PyOpenAL, so we redefine it like: </p> diff --git a/ebuild-writing/eapi/text.xml b/ebuild-writing/eapi/text.xml index 4943dba..5c2f9b7 100644 --- a/ebuild-writing/eapi/text.xml +++ b/ebuild-writing/eapi/text.xml @@ -1009,7 +1009,7 @@ pkg_postrm() { </codesample> <p> - In the example provided above, the ebuild needs to be update the icon cache + In the example provided above, the ebuild needs to update the icon cache upon being installed or uninstalled. By placing the respective tool in <c>IDEPEND</c>, the ebuild requests it to be available at the time of <c>pkg_postinst</c>. When cross-compiling, the tool will be built for diff --git a/ebuild-writing/messages/text.xml b/ebuild-writing/messages/text.xml index 36daa14..830e3cf 100644 --- a/ebuild-writing/messages/text.xml +++ b/ebuild-writing/messages/text.xml @@ -38,9 +38,8 @@ internal is the simplest <d/> it simply displays its parameters as a message. <p> The <c>elog</c> function can be used to display an informational message which is -meant to 'stand out' and is logged by the elog functionality in Portage 2.1 and -Paludis 0.6 or newer. On a colour terminal, the message provided will be prefixed -with a green asterisk. On earlier versions, elog behaves just like einfo. +meant to 'stand out' and is logged by Portage's elog functionality. On a colour +terminal, the message provided will be prefixed with a green asterisk. </p> <codesample lang="ebuild"> diff --git a/function-reference/query-functions/text.xml b/function-reference/query-functions/text.xml index 529bb77..49de81b 100644 --- a/function-reference/query-functions/text.xml +++ b/function-reference/query-functions/text.xml @@ -23,7 +23,7 @@ query variables and similar state. <c>use flagname</c> </ti> <ti> - Returns a true value if and only if <c>flagname</c> is enabled. + Returns a true value if <c>flagname</c> is enabled, false otherwise. The condition is inverted if prefixed with an exclamation mark, <c>!flagname</c>. It is guaranteed that <c>use</c> produces no output. diff --git a/general-concepts/dependencies/text.xml b/general-concepts/dependencies/text.xml index 3201d91..6c3207d 100644 --- a/general-concepts/dependencies/text.xml +++ b/general-concepts/dependencies/text.xml @@ -462,7 +462,7 @@ sub-slot changes of <c>wombat:0</c> should be ignored. <body> <p> -To depend upon a certain package if and only if a given <c>USE</c> flag is set: +To depend upon a certain package only if a given <c>USE</c> flag is set: </p> <codesample lang="ebuild"> diff --git a/quickstart/text.xml b/quickstart/text.xml index 32e3ede..9e22dfd 100644 --- a/quickstart/text.xml +++ b/quickstart/text.xml @@ -74,7 +74,7 @@ At the top of the ebuild is a header block. This is present in all ebuilds. </p> <p> -Ebuilds are indented using tabs, with each tab representing four places. +Ebuilds are indented using tabs, with each tab representing four spaces. See <uri link="::ebuild-writing/file-format/"/>. </p> </body> diff --git a/tasks-reference/pam/text.xml b/tasks-reference/pam/text.xml index 3094b20..2cc794c 100644 --- a/tasks-reference/pam/text.xml +++ b/tasks-reference/pam/text.xml @@ -80,15 +80,15 @@ The statement is composed of 3 or 4 tokens: methods. Some documentation states that we need to specify the full path of the module, but this creates problems because not all the systems install the modules in the same place: Linux-PAM on Gentoo is generally set up to load - them from <c>/lib/security</c>, but for example on AMD64 this become + them from <c>/lib/security</c>, but for example on AMD64 this becomes <c>/lib64/security</c>. The result is that providing the full path will lead to non-working <c>pamd</c> - files, and the right way to handle this is just states the module name <d /> the + files, and the right way to handle this is to just state the module name <d /> the PAM implementation will take care of finding the module. </li> <li> - The last token, which can consist of multiple items, describe the parameters - passed to the module. These are module-dependent. + The last token, which can consist of multiple items, describes the + parameters passed to the module. These are module-dependent. </li> </ul> <ul> @@ -124,7 +124,7 @@ source for some services, such as mail and ftp servers. <p> But for desktop systems, all the different services, such as mail servers, ftp -servers, ssh and so on, just need to authenticate in the same way the users logs +servers, ssh and so on, just need to authenticate in the same way the users log in to the system. </p> @@ -175,13 +175,13 @@ for <c>pamd</c> files (<c>dopamd</c> and <c>newpamd</c>, whose usage is the same similar <c>do*</c> and <c>new*</c> functions) and the <c>/etc/security</c> files (<c>dopamsecurity</c> and <c>newpamsecurity</c>, which need the first argument to be the subdirectory of <c>/etc/security</c> in which the files are to be installed). -Those groups of functions already takes care of verifying whether the <c>pam</c> +Those groups of functions already take care of verifying whether the <c>pam</c> USE flag is made optional for the package <d /> if this is the case, and the flag is disabled, the <c>pamd</c> files are just skipped. </p> <p> -Many <c>pamd</c> files just uses one or more auth types from <c>system-auth</c> login class, +Many <c>pamd</c> files just use one or more auth types from <c>system-auth</c> login class, which is the base one which provides login facilities for most services on common desktop systems. Instead of adding a <c>pamd</c> file in <c>${FILESDIR}</c> for this, one can use the <c>pamd_mimic_system</c> function. This function takes a series @@ -230,8 +230,8 @@ correct directory to use for the current implementation/arch. <p> When the PAM module doesn't provide a way to install the package by itself, such as a <c>Makefile</c> or an installation script, there are also the <c>dopammod</c> and -<c>newpammod</c> functions which takes care of install the module in the right -directory. +<c>newpammod</c> functions, which take care of installing the module in the +right directory. </p> </body> diff --git a/tools-reference/echo/text.xml b/tools-reference/echo/text.xml index 9a84ab9..404d319 100644 --- a/tools-reference/echo/text.xml +++ b/tools-reference/echo/text.xml @@ -29,12 +29,12 @@ the same as the former, but they won't print the trailing newline <p> All usage of the form <c>echo ${somevar} | grep substring</c> just to -check if the contents of the <c>${somevar}</c> variable -contains <c>substring</c>, or more often, <c>echo ${somevar} | -command</c>, are deprecated and should be (and in most cases, can be) -used as less as possible: doing so involves for no reason an -additional shell session and a pipe. The "here strings" section -describes the preferred way of dealing with such cases. +check if the content of the <c>${somevar}</c> variable contains +<c>substring</c>, or more often, <c>echo ${somevar} | command</c>, +is deprecated and should be (and in most cases, can be) avoided: +doing so involves for no reason an additional shell session and a pipe. +The "here strings" section describes the preferred way +of dealing with such cases. </p> </body> </section> @@ -43,11 +43,10 @@ describes the preferred way of dealing with such cases. <title>Here strings</title> <body> <p> -As of >=bash-2.05b, the so-called "here strings" have been -introduced. Using "here strings", you can pass contents of an +Using "here strings", you can pass contents of an environment variable to the standard input of an application, using <c><<<word</c> redirection: what actually happens is -that <c>bash</c> expands word and passes the result to the standard +that <c>bash</c> expands <c>word</c> and passes the result to the standard input. </p> diff --git a/tools-reference/find/text.xml b/tools-reference/find/text.xml index 5825a39..0abe239 100644 --- a/tools-reference/find/text.xml +++ b/tools-reference/find/text.xml @@ -77,7 +77,7 @@ Useful rules include: <ti><c>-maxdepth 3</c></ti> <ti> Only descend 3 levels into subdirectories. - <c>-maxdepth 1</c> will ignore all subdiretories of the specified path. + <c>-maxdepth 1</c> will ignore all subdirectories of the specified path. </ti> <ti>no, GNU and BSD</ti> </tr> diff --git a/tools-reference/grep/text.xml b/tools-reference/grep/text.xml index b0651bd..1aa17ba 100644 --- a/tools-reference/grep/text.xml +++ b/tools-reference/grep/text.xml @@ -32,9 +32,8 @@ being a fixed string rather than a regular expression. <p> By default, <c>grep</c> prints out matching lines from the input. If -<c>-q</c> is specified, no output is displayed. If <c>-l</c> (lowercase -letter ell) is specified, only the filenames of files which contain -matching lines are displayed. +<c>-q</c> is specified, no output is displayed. If <c>-l</c> is specified, +only the filenames of files which contain matching lines are displayed. </p> <p> |