d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

- Use existing functions mtx_lock() and mtx_unlock().

Browse Source 
- Change variable name to 'error', as this is what is mostly used for
  functions that return an error.
- Add mutex(9) to the SEE ALSO section.
- Bump the date.

I don't really like the example code. I'd prefer symmetry where possible, eg.

	mtx_lock(&example_lock);
	error = example(NULL, EXAMPLE_ONE);
	mtx_unlock(&example_lock);
	if (error != 0)
		return (error);

But I'll leave it as it is for now.

Reviewed by:	simon
This commit is contained in:
Pawel Jakub Dawidek 2006-09-27 08:39:00 +00:00
parent af159726bc
commit e5cccaf001
Notes: svn2git 2020-12-20 02:59:44 +00:00 
svn path=/head/; revision=162692
1 changed files with 9 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
share/examples/mdoc/example.9
View File

@ -26,7 +26,7 @@
.\"
.\" Note: The date here should be updated whenever a non-trivial
.\" change is made to the manual page.
.Dd January 12, 2005
.Dd September 27, 2006
.Dt EXAMPLE 9
.Os
.Sh NAME
@ -96,14 +96,14 @@ otherwise one of the values listed in the
section is returned, to indicate the error.
.Sh EXAMPLES
.Bd -literal
int val;
int error;
mutex_lock(&example_lock);
if ((val = example(NULL, EXAMPLE_ONE)) != 0) {
mutex_unlock(&example_lock);
return (val);
mtx_lock(&example_lock);
if ((error = example(NULL, EXAMPLE_ONE)) != 0) {
mtx_unlock(&example_lock);
return (error);
}
mutex_unlock(&example_lock);
mtx_unlock(&example_lock);
.Ed
.Sh COMPATIBILITY
The
@ -298,7 +298,8 @@ Programming error.
.Xr example 1 ,
.Xr example 3 ,
.Xr example 4 ,
.Xr mdoc 7
.Xr mdoc 7 ,
.Xr mutex 9
.Rs
.%A "A. B. Author"
.%T "Example RFC Title"