public inbox for util-linux@vger.kernel.org
 help / color / mirror / Atom feed
* [PATCH 08/16] libuuid/man/uuid_clear.3: Improve the typesetting of the manual
@ 2014-05-02  2:37 Bjarni Ingi Gislason
  2014-05-02  2:37 ` [PATCH 09/16] libuuid/man/uuid_compare.3: " Bjarni Ingi Gislason
                   ` (8 more replies)
  0 siblings, 9 replies; 10+ messages in thread
From: Bjarni Ingi Gislason @ 2014-05-02  2:37 UTC (permalink / raw)
  To: util-linux; +Cc: Bjarni Ingi Gislason

  Protect a full stop (.), that begins or ends a string, with \&

  Inhibit right adjusting for the section "SEE ALSO" with ".na/.ad", or
use '.ad l' for the entire manual

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
---
 libuuid/man/uuid_clear.3 | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/libuuid/man/uuid_clear.3 b/libuuid/man/uuid_clear.3
index edb80d6..70fca02 100644
--- a/libuuid/man/uuid_clear.3
+++ b/libuuid/man/uuid_clear.3
@@ -45,11 +45,12 @@ function sets the value of the supplied uuid variable
 .I uu
 to the NULL value.
 .SH AUTHOR
-Theodore Y. Ts'o
+Theodore Y.\& Ts'o
 .SH AVAILABILITY
 .B libuuid
 is part of the util-linux package since version 2.15.1 and is available from
 ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
+.na
 .SH "SEE ALSO"
 .BR uuid (3),
 .BR uuid_compare (3),
@@ -58,3 +59,4 @@ ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
 .BR uuid_is_null (3),
 .BR uuid_parse (3),
 .BR uuid_unparse (3)
+.ad
-- 
1.9.0


^ permalink raw reply related	[flat|nested] 10+ messages in thread

* [PATCH 09/16] libuuid/man/uuid_compare.3: Improve the typesetting of the manual
  2014-05-02  2:37 [PATCH 08/16] libuuid/man/uuid_clear.3: Improve the typesetting of the manual Bjarni Ingi Gislason
@ 2014-05-02  2:37 ` Bjarni Ingi Gislason
  2014-05-02  2:37 ` [PATCH 10/16] libuuid/man/uuid_copy.3: " Bjarni Ingi Gislason
                   ` (7 subsequent siblings)
  8 siblings, 0 replies; 10+ messages in thread
From: Bjarni Ingi Gislason @ 2014-05-02  2:37 UTC (permalink / raw)
  To: util-linux; +Cc: Bjarni Ingi Gislason

  Protect a full stop (.), that begins or ends a string, with \&

  Inhibit right adjusting for the section "SEE ALSO" with ".na/.ad", or
use '.ad l' for the entire manual

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
---
 libuuid/man/uuid_compare.3 | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/libuuid/man/uuid_compare.3 b/libuuid/man/uuid_compare.3
index 9300c51..f91181a 100644
--- a/libuuid/man/uuid_compare.3
+++ b/libuuid/man/uuid_compare.3
@@ -51,11 +51,12 @@ is found,  respectively, to be lexicographically less than, equal, or
 greater than
 .IR uu2 .
 .SH AUTHOR
-Theodore Y. Ts'o
+Theodore Y.\& Ts'o
 .SH AVAILABILITY
 .B libuuid
 is part of the util-linux package since version 2.15.1 and is available from
 ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
+.na
 .SH "SEE ALSO"
 .BR uuid (3),
 .BR uuid_clear (3),
@@ -64,3 +65,4 @@ ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
 .BR uuid_is_null (3),
 .BR uuid_parse (3),
 .BR uuid_unparse (3)
+.ad
-- 
1.9.0


^ permalink raw reply related	[flat|nested] 10+ messages in thread

* [PATCH 10/16] libuuid/man/uuid_copy.3: Improve the typesetting of the manual
  2014-05-02  2:37 [PATCH 08/16] libuuid/man/uuid_clear.3: Improve the typesetting of the manual Bjarni Ingi Gislason
  2014-05-02  2:37 ` [PATCH 09/16] libuuid/man/uuid_compare.3: " Bjarni Ingi Gislason
@ 2014-05-02  2:37 ` Bjarni Ingi Gislason
  2014-05-02  2:37 ` [PATCH 11/16] libuuid/man/uuid_generate.3: " Bjarni Ingi Gislason
                   ` (6 subsequent siblings)
  8 siblings, 0 replies; 10+ messages in thread
From: Bjarni Ingi Gislason @ 2014-05-02  2:37 UTC (permalink / raw)
  To: util-linux; +Cc: Bjarni Ingi Gislason

  Protect a full stop (.), that begins or ends a string, with \&

  Inhibit right adjusting for the section "SEE ALSO" with ".na/.ad", or
use '.ad l' for the entire manual

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
---
 libuuid/man/uuid_copy.3 | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/libuuid/man/uuid_copy.3 b/libuuid/man/uuid_copy.3
index f31d94e..5159fa6 100644
--- a/libuuid/man/uuid_copy.3
+++ b/libuuid/man/uuid_copy.3
@@ -47,11 +47,12 @@ function copies the UUID variable
 The copied UUID is returned in the location pointed to by
 .IR dst .
 .SH AUTHOR
-Theodore Y. Ts'o
+Theodore Y.\& Ts'o
 .SH AVAILABILITY
 .B libuuid
 is part of the util-linux package since version 2.15.1 and is available from
 ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
+.na
 .SH "SEE ALSO"
 .BR uuid (3),
 .BR uuid_clear (3),
@@ -60,3 +61,4 @@ ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
 .BR uuid_is_null (3),
 .BR uuid_parse (3),
 .BR uuid_unparse (3)
+.ad
-- 
1.9.0


^ permalink raw reply related	[flat|nested] 10+ messages in thread

* [PATCH 11/16] libuuid/man/uuid_generate.3: Improve the typesetting of the manual
  2014-05-02  2:37 [PATCH 08/16] libuuid/man/uuid_clear.3: Improve the typesetting of the manual Bjarni Ingi Gislason
  2014-05-02  2:37 ` [PATCH 09/16] libuuid/man/uuid_compare.3: " Bjarni Ingi Gislason
  2014-05-02  2:37 ` [PATCH 10/16] libuuid/man/uuid_copy.3: " Bjarni Ingi Gislason
@ 2014-05-02  2:37 ` Bjarni Ingi Gislason
  2014-05-02  2:37 ` [PATCH 12/16] libuuid/man/uuid_is_null.3: " Bjarni Ingi Gislason
                   ` (5 subsequent siblings)
  8 siblings, 0 replies; 10+ messages in thread
From: Bjarni Ingi Gislason @ 2014-05-02  2:37 UTC (permalink / raw)
  To: util-linux; +Cc: Bjarni Ingi Gislason

  Change '-' to '\-', if it means a minus

  Protect a full stop (.), that begins or ends a string, with \&

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
---
 libuuid/man/uuid_generate.3 | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/libuuid/man/uuid_generate.3 b/libuuid/man/uuid_generate.3
index 3bb789c..19904d7 100644
--- a/libuuid/man/uuid_generate.3
+++ b/libuuid/man/uuid_generate.3
@@ -104,11 +104,11 @@ and in the future.
 The newly created UUID is returned in the memory location pointed to by
 .IR out .
 .B uuid_generate_time_safe
-returns zero if the UUID has been generated in a safe manner, -1 otherwise.
+returns zero if the UUID has been generated in a safe manner, \-1 otherwise.
 .SH "CONFORMING TO"
 OSF DCE 1.1
 .SH AUTHOR
-Theodore Y. Ts'o
+Theodore Y.\& Ts'o
 .SH AVAILABILITY
 .B libuuid
 is part of the util-linux package since version 2.15.1 and is available from
-- 
1.9.0


^ permalink raw reply related	[flat|nested] 10+ messages in thread

* [PATCH 12/16] libuuid/man/uuid_is_null.3: Improve the typesetting of the manual
  2014-05-02  2:37 [PATCH 08/16] libuuid/man/uuid_clear.3: Improve the typesetting of the manual Bjarni Ingi Gislason
                   ` (2 preceding siblings ...)
  2014-05-02  2:37 ` [PATCH 11/16] libuuid/man/uuid_generate.3: " Bjarni Ingi Gislason
@ 2014-05-02  2:37 ` Bjarni Ingi Gislason
  2014-05-02  2:37 ` [PATCH 13/16] libuuid/man/uuid_parse.3: " Bjarni Ingi Gislason
                   ` (4 subsequent siblings)
  8 siblings, 0 replies; 10+ messages in thread
From: Bjarni Ingi Gislason @ 2014-05-02  2:37 UTC (permalink / raw)
  To: util-linux; +Cc: Bjarni Ingi Gislason

  Protect a full stop (.), that begins or ends a string, with \&

  Inhibit right adjusting for the section "SEE ALSO" with ".na/.ad", or
use '.ad l' for the entire manual

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
---
 libuuid/man/uuid_is_null.3 | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/libuuid/man/uuid_is_null.3 b/libuuid/man/uuid_is_null.3
index ccf24ed..86a7a50 100644
--- a/libuuid/man/uuid_is_null.3
+++ b/libuuid/man/uuid_is_null.3
@@ -46,11 +46,12 @@ function compares the value of the supplied UUID variable
 to the NULL value.  If the value is equal to the NULL UUID, 1 is returned,
 otherwise 0 is returned.
 .SH AUTHOR
-Theodore Y. Ts'o
+Theodore Y.\& Ts'o
 .SH AVAILABILITY
 .B libuuid
 is part of the util-linux package since version 2.15.1 and is available from
 ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
+.na
 .SH "SEE ALSO"
 .BR uuid (3),
 .BR uuid_clear (3),
@@ -60,3 +61,4 @@ ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
 .BR uuid_time (3),
 .BR uuid_parse (3),
 .BR uuid_unparse (3)
+.ad
-- 
1.9.0


^ permalink raw reply related	[flat|nested] 10+ messages in thread

* [PATCH 13/16] libuuid/man/uuid_parse.3: Improve the typesetting of the manual
  2014-05-02  2:37 [PATCH 08/16] libuuid/man/uuid_clear.3: Improve the typesetting of the manual Bjarni Ingi Gislason
                   ` (3 preceding siblings ...)
  2014-05-02  2:37 ` [PATCH 12/16] libuuid/man/uuid_is_null.3: " Bjarni Ingi Gislason
@ 2014-05-02  2:37 ` Bjarni Ingi Gislason
  2014-05-02  2:37 ` [PATCH 14/16] libuuid/man/uuid_time.3: " Bjarni Ingi Gislason
                   ` (3 subsequent siblings)
  8 siblings, 0 replies; 10+ messages in thread
From: Bjarni Ingi Gislason @ 2014-05-02  2:37 UTC (permalink / raw)
  To: util-linux; +Cc: Bjarni Ingi Gislason

  Use \e for the printable escape character instead of \\

  Protect a full stop (.), that begins or ends a string, with \&

  Inhibit right adjusting for the section "SEE ALSO" with ".na/.ad", or
use '.ad l' for the entire manual

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
---
 libuuid/man/uuid_parse.3 | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/libuuid/man/uuid_parse.3 b/libuuid/man/uuid_parse.3
index 9030345..31a5926 100644
--- a/libuuid/man/uuid_parse.3
+++ b/libuuid/man/uuid_parse.3
@@ -46,7 +46,7 @@ function converts the UUID string given by
 into the binary representation.  The input UUID is a string of the form
 1b4e28ba\-2fa1\-11d2\-883f\-b9a761bde3fb (in
 .BR printf (3)
-format "%08x\-%04x\-%04x\-%04x\-%012x", 36 bytes plus the trailing '\\0').
+format "%08x\-%04x\-%04x\-%04x\-%012x", 36 bytes plus the trailing '\e0').
 .SH RETURN VALUE
 Upon successfully parsing the input string, 0 is returned, and the UUID is
 stored in the location pointed to by
@@ -55,11 +55,12 @@ otherwise \-1 is returned.
 .SH "CONFORMING TO"
 OSF DCE 1.1
 .SH AUTHOR
-Theodore Y. Ts'o
+Theodore Y.\& Ts'o
 .SH AVAILABILITY
 .B libuuid
 is part of the util-linux package since version 2.15.1 and is available from
 ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
+.na
 .SH "SEE ALSO"
 .BR uuid (3),
 .BR uuid_clear (3),
@@ -69,3 +70,4 @@ ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
 .BR uuid_is_null (3),
 .BR uuid_time (3),
 .BR uuid_unparse (3)
+.ad
-- 
1.9.0


^ permalink raw reply related	[flat|nested] 10+ messages in thread

* [PATCH 14/16] libuuid/man/uuid_time.3: Improve the typesetting of the manual
  2014-05-02  2:37 [PATCH 08/16] libuuid/man/uuid_clear.3: Improve the typesetting of the manual Bjarni Ingi Gislason
                   ` (4 preceding siblings ...)
  2014-05-02  2:37 ` [PATCH 13/16] libuuid/man/uuid_parse.3: " Bjarni Ingi Gislason
@ 2014-05-02  2:37 ` Bjarni Ingi Gislason
  2014-05-02  2:37 ` [PATCH 15/16] libuuid/man/uuid_unparse.3: " Bjarni Ingi Gislason
                   ` (2 subsequent siblings)
  8 siblings, 0 replies; 10+ messages in thread
From: Bjarni Ingi Gislason @ 2014-05-02  2:37 UTC (permalink / raw)
  To: util-linux; +Cc: Bjarni Ingi Gislason

  Protect a full stop (.), that begins or ends a string, with \&

  Inhibit right adjusting for the section "SEE ALSO" with ".na/.ad", or
use '.ad l' for the entire manual

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
---
 libuuid/man/uuid_time.3 | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/libuuid/man/uuid_time.3 b/libuuid/man/uuid_time.3
index c2af0b6..483676b 100644
--- a/libuuid/man/uuid_time.3
+++ b/libuuid/man/uuid_time.3
@@ -60,11 +60,12 @@ the epoch, is also stored in the location pointed to by
 (see
 .BR gettimeofday "(2))."
 .SH AUTHOR
-Theodore Y. Ts'o
+Theodore Y.\& Ts'o
 .SH AVAILABILITY
 .B libuuid
 is part of the util-linux package since version 2.15.1 and is available from
 ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
+.na
 .SH "SEE ALSO"
 .BR uuid (3),
 .BR uuid_clear (3),
@@ -74,3 +75,4 @@ ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
 .BR uuid_is_null (3),
 .BR uuid_parse (3),
 .BR uuid_unparse (3)
+.ad
-- 
1.9.0


^ permalink raw reply related	[flat|nested] 10+ messages in thread

* [PATCH 15/16] libuuid/man/uuid_unparse.3: Improve the typesetting of the manual
  2014-05-02  2:37 [PATCH 08/16] libuuid/man/uuid_clear.3: Improve the typesetting of the manual Bjarni Ingi Gislason
                   ` (5 preceding siblings ...)
  2014-05-02  2:37 ` [PATCH 14/16] libuuid/man/uuid_time.3: " Bjarni Ingi Gislason
@ 2014-05-02  2:37 ` Bjarni Ingi Gislason
  2014-05-02  2:37 ` [PATCH 16/16] libuuid/man/uuid.3: " Bjarni Ingi Gislason
  2014-05-06 10:02 ` [PATCH 08/16] libuuid/man/uuid_clear.3: " Karel Zak
  8 siblings, 0 replies; 10+ messages in thread
From: Bjarni Ingi Gislason @ 2014-05-02  2:37 UTC (permalink / raw)
  To: util-linux; +Cc: Bjarni Ingi Gislason

  Change '\-' (minus) to '-' (code "hyphen-minus", rendered with the
glyph 'hyphen' in troff), if it is a part of a compound word.

  Use \e to print the escape character, instead of \\, as \e is not
interpreted in copy mode

  Protect a full stop (.), that begins or ends a string, with \&

  Inhibit right adjusting for the section "SEE ALSO" with ".na/.ad", or
use '.ad l' for the entire manual

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
---
 libuuid/man/uuid_unparse.3 | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/libuuid/man/uuid_unparse.3 b/libuuid/man/uuid_unparse.3
index a7ab5d8..1e0116d 100644
--- a/libuuid/man/uuid_unparse.3
+++ b/libuuid/man/uuid_unparse.3
@@ -45,7 +45,7 @@ The
 .B uuid_unparse
 function converts the supplied UUID
 .I uu
-from the binary representation into a 36\-byte string (plus tailing '\\0')
+from the binary representation into a 36-byte string (plus tailing '\e0')
 of the form 1b4e28ba\-2fa1\-11d2\-883f\-0016d3cca427 and stores this
 value in the character string pointed to by
 .IR out .
@@ -63,11 +63,12 @@ may be used.
 .SH "CONFORMING TO"
 OSF DCE 1.1
 .SH AUTHOR
-Theodore Y. Ts'o
+Theodore Y.\& Ts'o
 .SH AVAILABILITY
 .B libuuid
 is part of the util-linux package since version 2.15.1 and is available from
 ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
+.na
 .SH "SEE ALSO"
 .BR uuid (3),
 .BR uuid_clear (3),
@@ -77,3 +78,4 @@ ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
 .BR uuid_time (3),
 .BR uuid_is_null (3),
 .BR uuid_parse (3)
+.ad
-- 
1.9.0


^ permalink raw reply related	[flat|nested] 10+ messages in thread

* [PATCH 16/16] libuuid/man/uuid.3: Improve the typesetting of the manual
  2014-05-02  2:37 [PATCH 08/16] libuuid/man/uuid_clear.3: Improve the typesetting of the manual Bjarni Ingi Gislason
                   ` (6 preceding siblings ...)
  2014-05-02  2:37 ` [PATCH 15/16] libuuid/man/uuid_unparse.3: " Bjarni Ingi Gislason
@ 2014-05-02  2:37 ` Bjarni Ingi Gislason
  2014-05-06 10:02 ` [PATCH 08/16] libuuid/man/uuid_clear.3: " Karel Zak
  8 siblings, 0 replies; 10+ messages in thread
From: Bjarni Ingi Gislason @ 2014-05-02  2:37 UTC (permalink / raw)
  To: util-linux; +Cc: Bjarni Ingi Gislason

  Protect a full stop (.), that begins or ends a string, with \&

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
---

Notes (default):
    I am checking the man pages in alphabetic order (<dir>/<name>) with a script

 libuuid/man/uuid.3 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/libuuid/man/uuid.3 b/libuuid/man/uuid.3
index 62b99eb..37b0499 100644
--- a/libuuid/man/uuid.3
+++ b/libuuid/man/uuid.3
@@ -49,7 +49,7 @@ of a name clash.
 .SH "CONFORMING TO"
 OSF DCE 1.1
 .SH AUTHOR
-Theodore Y. Ts'o
+Theodore Y.\& Ts'o
 .SH AVAILABILITY
 .B libuuid
 is part of the util-linux package since version 2.15.1 and is available from
-- 
1.9.0


^ permalink raw reply related	[flat|nested] 10+ messages in thread

* Re: [PATCH 08/16] libuuid/man/uuid_clear.3: Improve the typesetting of the manual
  2014-05-02  2:37 [PATCH 08/16] libuuid/man/uuid_clear.3: Improve the typesetting of the manual Bjarni Ingi Gislason
                   ` (7 preceding siblings ...)
  2014-05-02  2:37 ` [PATCH 16/16] libuuid/man/uuid.3: " Bjarni Ingi Gislason
@ 2014-05-06 10:02 ` Karel Zak
  8 siblings, 0 replies; 10+ messages in thread
From: Karel Zak @ 2014-05-06 10:02 UTC (permalink / raw)
  To: Bjarni Ingi Gislason; +Cc: util-linux

On Fri, May 02, 2014 at 02:37:33AM +0000, Bjarni Ingi Gislason wrote:
> diff --git a/libuuid/man/uuid_clear.3 b/libuuid/man/uuid_clear.3
> index edb80d6..70fca02 100644
> --- a/libuuid/man/uuid_clear.3
> +++ b/libuuid/man/uuid_clear.3

 All libuuid/man patches applied. Thanks.

 Note that it's better to use "libuuid: " prefix for the patches.
 We use the prefix to aggregate all changes in the ReleaseNotes files.

    Karel

-- 
 Karel Zak  <kzak@redhat.com>
 http://karelzak.blogspot.com

^ permalink raw reply	[flat|nested] 10+ messages in thread

end of thread, other threads:[~2014-05-06 10:02 UTC | newest]

Thread overview: 10+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2014-05-02  2:37 [PATCH 08/16] libuuid/man/uuid_clear.3: Improve the typesetting of the manual Bjarni Ingi Gislason
2014-05-02  2:37 ` [PATCH 09/16] libuuid/man/uuid_compare.3: " Bjarni Ingi Gislason
2014-05-02  2:37 ` [PATCH 10/16] libuuid/man/uuid_copy.3: " Bjarni Ingi Gislason
2014-05-02  2:37 ` [PATCH 11/16] libuuid/man/uuid_generate.3: " Bjarni Ingi Gislason
2014-05-02  2:37 ` [PATCH 12/16] libuuid/man/uuid_is_null.3: " Bjarni Ingi Gislason
2014-05-02  2:37 ` [PATCH 13/16] libuuid/man/uuid_parse.3: " Bjarni Ingi Gislason
2014-05-02  2:37 ` [PATCH 14/16] libuuid/man/uuid_time.3: " Bjarni Ingi Gislason
2014-05-02  2:37 ` [PATCH 15/16] libuuid/man/uuid_unparse.3: " Bjarni Ingi Gislason
2014-05-02  2:37 ` [PATCH 16/16] libuuid/man/uuid.3: " Bjarni Ingi Gislason
2014-05-06 10:02 ` [PATCH 08/16] libuuid/man/uuid_clear.3: " Karel Zak

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox