Hi Carey,

sorry for the delay of my answer.

On Sun, 28 Dec 2014, Carey Walker wrote:
> Here's a first attempt. Just one appendix for now. 99% style/readability -
> haven't attempted anything much technical.

It's good! I have merged it with a few fixes:

> @@ -123,8 +123,8 @@ Documents  Music      Public</computeroutput>
>        <replaceable>file</replaceable> with
>        “<replaceable>text</replaceable>” as its contents. Adding a line
>        at the end of this file is possible too, with a command such as
> -      <command>echo "<replaceable>line</replaceable>"
> -      &gt;&gt;<replaceable>file</replaceable></command>.</para>
> +      <command>echo "<replaceable>moretext</replaceable>"
> +      &gt;&gt;<replaceable>file</replaceable></command>. Note the >> in this 
> example.</para>

">>" should have been "&gt;&gt;" and possibly marked with some
tag: <literal>&gt;&gt;</literal>

> @@ -288,7 +288,8 @@ tmpfs                   514208    269136    245072  53% 
> /dev/shm
>          <listitem>
>         <para><filename>/proc/</filename> and <filename>/sys/</filename>
>         are specific to the Linux kernel (and not part of the FHS). They
> -       are used by the kernel for exporting data to user-space.</para>
> +       are used by the kernel for exporting data to user-space
> +          (see the section following for a description of the User 
> Space).</para>
>          </listitem>

Here you should put a real cross-reference link:
(see <xref linkend="sect.userspace-presentation" /> and <xref
linkend="sect.user-space" /> for explanations about this
concept)

> -     <para>The restriction described here is only a corner
> -     case. The actual restriction is that there can only be one
> +     <para>The limitation described above of only one process being able to 
> run 
> +        at a time, doesn't always apply. The actual restriction is that 
> there can only be one

Try to wrap lines at 80 characters.

>        <para>For more complex communications, there are also mechanisms
>        allowing a process to open access, or share, part of its
> -      allocated memory to other processes. Memory shared between them
> -      can be used to move data across.</para>
> +      allocated memory to other processes. Memory now shared between them
> +      can be used to move data beteen the processes.</para>

s/beteen/between/

Cheers,
-- 
Raphaël Hertzog ◈ Debian Developer

Support Debian LTS: http://www.freexian.com/services/debian-lts.html
Learn to master Debian: http://debian-handbook.info/get/


-- 
To UNSUBSCRIBE, email to [email protected]
with a subject of "unsubscribe". Trouble? Contact [email protected]

Reply via email to