[patch] user_namespaces.7: Fix two groff warnings for escape character ignored

[patch] user_namespaces.7: Fix two groff warnings for escape character ignored

[saulery-GANU6spQydw]

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

Signed-off-by: Stéphane Aulery <saulery-GANU6spQydw@public.gmane.org>
---
 man7/user_namespaces.7 | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/man7/user_namespaces.7 b/man7/user_namespaces.7
index 4baf7aa..0e24d9a 100644
--- a/man7/user_namespaces.7
+++ b/man7/user_namespaces.7
@@ -439,12 +439,12 @@ maps to a range starting at 0 in the (nonexistent) parent namespace,
 and the length of the range is the largest 32-bit unsigned integer.
 (This deliberately leaves 4294967295 (the 32-bit signed \-1 value) unmapped.
 This is deliberate:
-.IR "(uid_t)\ -\1"
+.IR "(uid_t) -1"
 is used in several interfaces (e.g.,
 .BR setreuid (2))
 as a way to specify "no user ID".
 Leaving
-.IR "(uid_t)\ -\1"
+.IR "(uid_t) -1"
 unmapped and unusable guarantees that there will be no
 confusion when using these interfaces.
 .\"
-- 
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] user_namespaces.7: Fix two groff warnings for escape character ignored

[Michael Kerrisk (man-pages)]

Hi Stéphane

When do you see these warnings? (I'm not seeing them.)

Cheers,

Michael

On 02/26/2015 09:23 AM, saulery-GANU6spQydw@public.gmane.org wrote:
> From: Stéphane Aulery <saulery-GANU6spQydw@public.gmane.org>
> 
> Signed-off-by: Stéphane Aulery <saulery-GANU6spQydw@public.gmane.org>
> ---
>  man7/user_namespaces.7 | 4 ++--
>  1 file changed, 2 insertions(+), 2 deletions(-)
> 
> diff --git a/man7/user_namespaces.7 b/man7/user_namespaces.7
> index 4baf7aa..0e24d9a 100644
> --- a/man7/user_namespaces.7
> +++ b/man7/user_namespaces.7
> @@ -439,12 +439,12 @@ maps to a range starting at 0 in the (nonexistent) parent namespace,
>  and the length of the range is the largest 32-bit unsigned integer.
>  (This deliberately leaves 4294967295 (the 32-bit signed \-1 value) unmapped.
>  This is deliberate:
> -.IR "(uid_t)\ -\1"
> +.IR "(uid_t) -1"
>  is used in several interfaces (e.g.,
>  .BR setreuid (2))
>  as a way to specify "no user ID".
>  Leaving
> -.IR "(uid_t)\ -\1"
> +.IR "(uid_t) -1"
>  unmapped and unusable guarantees that there will be no
>  confusion when using these interfaces.
>  .\"
> 


-- 
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

Re: [patch] user_namespaces.7: Fix two groff warnings for escape character ignored

[Stéphane Aulery]

Hi Michael,

Le jeudi 26 février 2015 à 10:07:02, Michael Kerrisk (man-pages) a écrit :
> 
> When do you see these warnings? (I'm not seeing them.)

I use the command bellow for "debugging" manpages :

   $ GROFF_ENCODING=utf8 groff -b -ww -z -mandoc

Cheers,

-- 
Stéphane Aulery
--
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] user_namespaces.7: Fix two groff warnings for escape character ignored

[Michael Kerrisk (man-pages)]

Hello Stéphane

On 26 February 2015 at 10:39, Stéphane Aulery <saulery-GANU6spQydw@public.gmane.org> wrote:
> Hi Michael,
>
> Le jeudi 26 février 2015 à 10:07:02, Michael Kerrisk (man-pages) a écrit :
>>
>> When do you see these warnings? (I'm not seeing them.)
>
> I use the command bellow for "debugging" manpages :
>
>    $ GROFF_ENCODING=utf8 groff -b -ww -z -mandoc

Thanks. I see now that the problem was a typo (twice). I applied the
right fix, below. Thanks for the report.

Cheers,

Michael


diff --git a/man7/user_namespaces.7 b/man7/user_namespaces.7
index 4baf7aa..0a670a6 100644
--- a/man7/user_namespaces.7
+++ b/man7/user_namespaces.7
@@ -439,12 +439,12 @@ maps to a range starting at 0 in the
(nonexistent) parent namespace,
 and the length of the range is the largest 32-bit unsigned integer.
 (This deliberately leaves 4294967295 (the 32-bit signed \-1 value) unmapped.
 This is deliberate:
-.IR "(uid_t)\ -\1"
+.IR "(uid_t)\ \-1"
 is used in several interfaces (e.g.,
 .BR setreuid (2))
 as a way to specify "no user ID".
 Leaving
-.IR "(uid_t)\ -\1"
+.IR "(uid_t)\ \-1"
 unmapped and unusable guarantees that there will be no
 confusion when using these interfaces.
 .\"


-- 
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