[src/trunk]: src/share/man/man3 Paraphrase slightly.

[jruoho <jruoho%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/dd182c7fc793
branches:  trunk
changeset: 759779:dd182c7fc793
user:      jruoho <jruoho%NetBSD.org@localhost>
date:      Thu Dec 16 15:55:41 2010 +0000

description:
Paraphrase slightly.

diffstat:

 share/man/man3/attribute.3 |  18 ++++++++++--------
 1 files changed, 10 insertions(+), 8 deletions(-)

diffs (46 lines):

diff -r 262085379784 -r dd182c7fc793 share/man/man3/attribute.3
--- a/share/man/man3/attribute.3        Thu Dec 16 15:30:56 2010 +0000
+++ b/share/man/man3/attribute.3        Thu Dec 16 15:55:41 2010 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: attribute.3,v 1.3 2010/12/16 10:40:43 jruoho Exp $
+.\" $NetBSD: attribute.3,v 1.4 2010/12/16 15:55:41 jruoho Exp $
 .\"
 .\" Copyright (c) 2010 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -69,6 +69,10 @@
 or
 .Vt union ,
 all variables therein are also packed.
+The
+.Ic __packed
+macro is often useful when dealing with data that
+is in a particular static format on the disk, wire, or memory.
 .It Fn __aligned "x"
 The
 .Fn __aligned
@@ -95,15 +99,13 @@
 Note that when used with functions, structures, or structure members,
 .Fn __aligned
 can only be used to increase the alignment.
-It is however possible to decrease the alignment
+If the macro is however used as part of a
+.Vt typedef ,
+the alignment can both increase and decrease.
+Otherwise it is only possible to decrease the alignment
 for variables and fields by using the
 .Ic __packed
 macro.
-If
-.Fn __aligned
-is used as part of a
-.Vt typedef ,
-the alignment can both increase and decrease.
 The effectiveness of
 .Fn __aligned
 is largely dependent on the linker.
@@ -134,4 +136,4 @@
 should steer clear from non-standard extensions specific
 to any given compiler.
 Even when portability is not a concern,
-use these macros wisely.
+use these macros sparsely and wisely.