[PATCH] hier.7: document /initrd, /lost+found and /sys

[PATCH] hier.7: document /initrd, /lost+found and /sys

[Stéphane Aulery]

Ubuntu Bug #70094 reported by Brian Beck

https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/70094
Signed-off-by: Stéphane Aulery <saulery-GANU6spQydw@public.gmane.org>
---
 man7/hier.7 | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/man7/hier.7 b/man7/hier.7
index 77f365c..f28b384 100644
--- a/man7/hier.7
+++ b/man7/hier.7
@@ -51,6 +51,10 @@ and configuration files should go to
 .I /sbin
 and
 .IR /etc .
+The operating system kernel (initrd for example) must be located in either
+.I /
+or
+.IR /boot .
 .TP
 .I /dev
 Special or device files, which refer to physical devices.
@@ -107,6 +111,11 @@ libraries (optional).
 .I /lib/modules
 Loadable kernel modules (optional).
 .TP
+.I /lost+found
+This directory contains items lost on file system.
+These items are usually chunks of files
+mangled by a slowly rotting disk.
+.TP
 .I /media
 This directory contains mount points for removable media such as CD
 and DVD disks or USB sticks.
@@ -161,6 +170,14 @@ usually not executed by normal users.
 .I /srv
 This directory contains site-specific data that is served by this system.
 .TP
+.I /sys
+This is a mount point for the sysfr filesystem, which provides information
+about the kernel.
+It was created to replace
+.I /proc
+and provide more structured information.
+Any new information on the kernel is added to this file system.
+.TP
 .I /tmp
 This directory contains temporary files which may be deleted with no
 notice, such as by a regular job or at system boot up.
-- 
2.1.4

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] hier.7: document /initrd, /lost+found and /sys

[Michael Kerrisk (man-pages)]

Hello Stéphane,

On 15 March 2015 at 13:46, Stéphane Aulery <saulery-GANU6spQydw@public.gmane.org> wrote:
> Ubuntu Bug #70094 reported by Brian Beck
>
> https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/70094
> Signed-off-by: Stéphane Aulery <saulery-GANU6spQydw@public.gmane.org>
> ---
>  man7/hier.7 | 17 +++++++++++++++++
>  1 file changed, 17 insertions(+)
>
> diff --git a/man7/hier.7 b/man7/hier.7
> index 77f365c..f28b384 100644
> --- a/man7/hier.7
> +++ b/man7/hier.7
> @@ -51,6 +51,10 @@ and configuration files should go to
>  .I /sbin
>  and
>  .IR /etc .
> +The operating system kernel (initrd for example) must be located in either
> +.I /
> +or
> +.IR /boot .
>  .TP
>  .I /dev
>  Special or device files, which refer to physical devices.
> @@ -107,6 +111,11 @@ libraries (optional).
>  .I /lib/modules
>  Loadable kernel modules (optional).
>  .TP
> +.I /lost+found
> +This directory contains items lost on file system.

"filesystem" -- no space.

s/on/in the/

> +These items are usually chunks of files
> +mangled by a slowly rotting disk.

==> mangled as a consequence of a faulty disk or a system crash.
?

> +.TP
>  .I /media
>  This directory contains mount points for removable media such as CD
>  and DVD disks or USB sticks.
> @@ -161,6 +170,14 @@ usually not executed by normal users.
>  .I /srv
>  This directory contains site-specific data that is served by this system.
>  .TP
> +.I /sys
> +This is a mount point for the sysfr filesystem, which provides information

s/sysfr/sysfs/ I think.

> +about the kernel.
> +It was created to replace
> +.I /proc
> +and provide more structured information.

That's not accurate, I think. /proc isn't going away any time soon.

> +Any new information on the kernel is added to this file system.

I think that last sentence can be dropped.

Cheers,

Michael

> +.TP
>  .I /tmp
>  This directory contains temporary files which may be deleted with no
>  notice, such as by a regular job or at system boot up.
> --
> 2.1.4
>



-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[PATCH] hier.7: document /initrd, /lost+found and /sys

[saulery-GANU6spQydw]

From: Stéphane Aulery <saulery-GANU6spQydw@public.gmane.org>

Ubuntu Bug #70094 reported by Brian Beck

https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/70094
Signed-off-by: Stéphane Aulery <saulery-GANU6spQydw@public.gmane.org>
---
 man7/hier.7 | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/man7/hier.7 b/man7/hier.7
index 77f365c..615ad65 100644
--- a/man7/hier.7
+++ b/man7/hier.7
@@ -51,6 +51,10 @@ and configuration files should go to
 .I /sbin
 and
 .IR /etc .
+The operating system kernel (initrd for example) must be located in either
+.I /
+or
+.IR /boot .
 .TP
 .I /dev
 Special or device files, which refer to physical devices.
@@ -107,6 +111,11 @@ libraries (optional).
 .I /lib/modules
 Loadable kernel modules (optional).
 .TP
+.I /lost+found
+This directory contains items lost in the filesystem.
+These items are usually chunks of files mangled as a consequence of
+a faulty disk or a system crash.
+.TP
 .I /media
 This directory contains mount points for removable media such as CD
 and DVD disks or USB sticks.
@@ -161,6 +170,12 @@ usually not executed by normal users.
 .I /srv
 This directory contains site-specific data that is served by this system.
 .TP
+.I /sys
+This is a mount point for the sysfs filesystem, which provides information
+about the kernel like
+.IR /proc ,
+but better structured, following the formalism of kobject infrastructure.
+.TP
 .I /tmp
 This directory contains temporary files which may be deleted with no
 notice, such as by a regular job or at system boot up.
-- 
2.1.4

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] hier.7: document /initrd, /lost+found and /sys

[Michael Kerrisk (man-pages)]

On 03/22/2015 09:37 PM, saulery-GANU6spQydw@public.gmane.org wrote:
> From: Stéphane Aulery <saulery-GANU6spQydw@public.gmane.org>

Thanks, Stéphane.

Applied.

Cheers,

Michael


> Ubuntu Bug #70094 reported by Brian Beck
> 
> https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/70094
> Signed-off-by: Stéphane Aulery <saulery-GANU6spQydw@public.gmane.org>
> ---
>  man7/hier.7 | 15 +++++++++++++++
>  1 file changed, 15 insertions(+)
> 
> diff --git a/man7/hier.7 b/man7/hier.7
> index 77f365c..615ad65 100644
> --- a/man7/hier.7
> +++ b/man7/hier.7
> @@ -51,6 +51,10 @@ and configuration files should go to
>  .I /sbin
>  and
>  .IR /etc .
> +The operating system kernel (initrd for example) must be located in either
> +.I /
> +or
> +.IR /boot .
>  .TP
>  .I /dev
>  Special or device files, which refer to physical devices.
> @@ -107,6 +111,11 @@ libraries (optional).
>  .I /lib/modules
>  Loadable kernel modules (optional).
>  .TP
> +.I /lost+found
> +This directory contains items lost in the filesystem.
> +These items are usually chunks of files mangled as a consequence of
> +a faulty disk or a system crash.
> +.TP
>  .I /media
>  This directory contains mount points for removable media such as CD
>  and DVD disks or USB sticks.
> @@ -161,6 +170,12 @@ usually not executed by normal users.
>  .I /srv
>  This directory contains site-specific data that is served by this system.
>  .TP
> +.I /sys
> +This is a mount point for the sysfs filesystem, which provides information
> +about the kernel like
> +.IR /proc ,
> +but better structured, following the formalism of kobject infrastructure.
> +.TP
>  .I /tmp
>  This directory contains temporary files which may be deleted with no
>  notice, such as by a regular job or at system boot up.
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html