cvs commit: src/share/man/man9 g_access.9 g_attach.9 g_bio.9 g_consumer.9 g_data.9 g_event.9 g_provider.9 g_provider_by_name.9 g_wither_geom.9

[Pawel Jakub Dawidek]

On Tue, May 18, 2004 at 04:33:37AM -0700, Lukas Ertl wrote:
+> le          2004/05/18 04:33:37 PDT
+> 
+>   FreeBSD src repository
+> 
+>   Modified files:
+>     share/man/man9       g_access.9 g_attach.9 g_bio.9 
+>                          g_consumer.9 g_data.9 g_event.9 
+>                          g_provider.9 g_provider_by_name.9 
+>                          g_wither_geom.9 
+>   Log:
+>   Update several GEOM related manual pages:
+>   
+>     *) Fix spelling errors.
+>     *) Better english.
+>     *) Re-phrasing.

Everything looks ok, only few things.

+>  .Sh DESCRIPTION
+>  The
+>  .Fn g_attach
+> -function attaches given consumer to given provider.
+> -For real provider access (ie. I/O operations), one still need to call the
+> -.Fn g_access
+> -function on consumer to gain access to attached provider.
+> +function attaches given consumer
+> +.Fa cp
+> +to given provider
+> +.Fa pp ,
+> +thus establishing a communication channel between the consumer and the
+> +provider that allows to change access counts or perform I/O operations.

I'm not sure "or" is right word here, as we first _must_ change access
count and then we can perform I/O operations.

+>  .It Dv BIO_GETATTR
+> -Get attribute supports inspection and manipulation of out\-of\-band
+> +Inspect and manipulate out\-of\-band
+>  attributes on a particular provider or path.

Those \ aren't needed here.

+> -The provider name is created in a printf\-like way from the rest of
+> +The name of the provider, which will appear as device in devfs, is created
+> +in a printf\-like way from the rest of

We don't need \ here as well.

Thanks for those cleanups and sorry once again.

-- 
Pawel Jakub Dawidek                       http://www.FreeBSD.org
pjd at FreeBSD.org                           http://garage.freebsd.pl
FreeBSD committer                         Am I Evil? Yes, I Am!
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
Url : http://lists.freebsd.org/pipermail/cvs-src/attachments/20040518/64243b31/attachment.bin