Bug#725402: debian-handbook: Minor style and readability enhancements

2015-01-27 Thread Carey Walker
Hi Raphael

Quick question. When I got the above feedback, pretty sure I recall going
to the handbook page a doing a quick online browse to see how the accepted
changes turned out. Also pretty sure I saw all the changes I sent back!

I went back today to look at something again and can't see any of the
changes. Maybe I'm going mad, but just wanted to check if there has been a
roll-back maybe to an earlier version since I last looked at it?

Thanks.

On Fri, Jan 9, 2015 at 8:22 PM, Raphael Hertzog  wrote:

> 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
> >file with
> >“text” as its contents. Adding a line
> >at the end of this file is possible too, with a command such as
> > -  echo "line"
> > -  >>file.
> > +  echo "moretext"
> > +  >>file. Note the >> in
> this example.
>
> ">>" should have been ">>" and possibly marked with some
> tag: >>
>
> > @@ -288,7 +288,8 @@ tmpfs   514208269136245072
> 53% /dev/shm
> >  
> > /proc/ and /sys/
> > are specific to the Linux kernel (and not part of the FHS). They
> > -   are used by the kernel for exporting data to user-space.
> > +   are used by the kernel for exporting data to user-space
> > +  (see the section following for a description of the User
> Space).
> >  
>
> Here you should put a real cross-reference link:
> (see  and  linkend="sect.user-space" /> for explanations about this
> concept)
>
> > - The restriction described here is only a corner
> > - case. The actual restriction is that there can only be one
> > + 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.
>
> >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.
> > +  allocated memory to other processes. Memory now shared between
> them
> > +  can be used to move data beteen the processes.
>
> 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/
>


Bug#725402: debian-handbook: Minor style and readability enhancements

2015-01-09 Thread Carey Walker
Thanks. Changes noted and I'll use the suggestions for future edits.

Now I understand the process better I will start on another section.

Regards

Carey
On 09/01/2015 8:22 PM, "Raphael Hertzog"  wrote:

> 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
> >file with
> >“text” as its contents. Adding a line
> >at the end of this file is possible too, with a command such as
> > -  echo "line"
> > -  >>file.
> > +  echo "moretext"
> > +  >>file. Note the >> in
> this example.
>
> ">>" should have been ">>" and possibly marked with some
> tag: >>
>
> > @@ -288,7 +288,8 @@ tmpfs   514208269136245072
> 53% /dev/shm
> >  
> > /proc/ and /sys/
> > are specific to the Linux kernel (and not part of the FHS). They
> > -   are used by the kernel for exporting data to user-space.
> > +   are used by the kernel for exporting data to user-space
> > +  (see the section following for a description of the User
> Space).
> >  
>
> Here you should put a real cross-reference link:
> (see  and  linkend="sect.user-space" /> for explanations about this
> concept)
>
> > - The restriction described here is only a corner
> > - case. The actual restriction is that there can only be one
> > + 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.
>
> >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.
> > +  allocated memory to other processes. Memory now shared between
> them
> > +  can be used to move data beteen the processes.
>
> 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/
>