272461 |
03-Oct-2014 |
gjb |
Copy stable/10@r272459 to releng/10.1 as part of the 10.1-RELEASE process.
Approved by: re (implicit) Sponsored by: The FreeBSD Foundation
|
256281 |
10-Oct-2013 |
gjb |
Copy head (r256279) to stable/10 as part of the 10.0-RELEASE cycle.
Approved by: re (implicit) Sponsored by: The FreeBSD Foundation
|
237018 |
13-Jun-2012 |
joel |
Sync example file with mdoc changes made in rev 235450.
|
162712 |
27-Sep-2006 |
danger |
Revert my previous change as it does not seem to be entirely correct and popular.
|
162692 |
27-Sep-2006 |
pjd |
- Use existing functions mtx_lock() and mtx_unlock(). - 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
|
162670 |
26-Sep-2006 |
danger |
Remove second person from the sentece and rephrase a bit.
Approved by: trhodes (mentor), keramida (mentor)
|
162403 |
18-Sep-2006 |
ru |
Fix wording to what I intended originally.
|
162396 |
18-Sep-2006 |
ru |
- Avoid using second person. - Demonstrate how .Nm can be used without the side effect of causing a line break in the SYNOPSIS section.
|
158763 |
20-May-2006 |
brueffer |
Make this example more real world usable: When the manpage first appeared is not interesting, when the driver appeared is. Most people who use this example leave the manpage appearance date in and the driver date out.
MFC after: 3 days
|
157356 |
01-Apr-2006 |
brueffer |
Add a standard boilerplate to the SYNOPSIS section that mentions how to load a kernel module.
MFC after: 3 days
|
145982 |
07-May-2005 |
brueffer |
Join two lines.
|
140363 |
16-Jan-2005 |
ru |
Added the EXIT STATUS section.
|
140302 |
15-Jan-2005 |
jkoshy |
Move the LOCKING section to before the EXAMPLES section. Make example locking calls in the EXAMPLES section.
Reviewed by: keramida
|
140139 |
12-Jan-2005 |
keramida |
A few more mdoc fixes I missed in the suggestions of Ruslan.
|
140135 |
12-Jan-2005 |
keramida |
Cross-reference the newly added example.9
|
140133 |
12-Jan-2005 |
keramida |
Add a sample manpage for section 9.
Suggested by: simon Reviewed by: ru
|
139992 |
10-Jan-2005 |
ru |
Forgot to submit a fixed version of this script to Simon.
|
139989 |
10-Jan-2005 |
simon |
Add support files for using text from the POSIX specification in FreeBSD manual pages:
- POSIX-copyright contains copyright text to be used in manual pages which has POSIX text inserted. - deshallify.sh is a shell script which removes many of the ``shall'' statements from the POSIX text and therefore making the text more readable.
Real work to make this happen by: nectar, ru
|
133944 |
18-Aug-2004 |
simon |
Add a HARDWARE section to the example section 4 manual page.
Reviewed by: ru MFC after: 3 days
|
132878 |
30-Jul-2004 |
ru |
Update to the 2004 Edition of POSIX.
|
131751 |
07-Jul-2004 |
ru |
Bumped document date for the recent changes here. Fixed bad example of how to start a new sentence. Added missing punctuation. Fixed cut-n-paste error in the STANDARDS section. Mention modern POSIX and C standards.
|
130784 |
20-Jun-2004 |
mpp |
Grr. Fixup markup on my last commit. Sorry, I'm a little out of practice :)
|
130783 |
20-Jun-2004 |
mpp |
Sync up ERRORS section with errno.h.
|
119893 |
08-Sep-2003 |
ru |
mdoc(7): Use the new feature of the .In macro.
|
80807 |
01-Aug-2001 |
obrien |
It appears we really shouldn't be following this example man page -- one should not use a `%' in examples.
I don't know if this is the consensus of doc@, or just a unilateral decision of committer that corrected my following of this example. Maybe a docs person could review these files and see if they still show current guidelines.
|
79857 |
18-Jul-2001 |
ru |
Removed the comment that required all FreeBSD manpages to have the $FreeBSD$ keyword, as this is now enforced by the CVSROOT/commit_prep.pl script.
Fold multi-word macro arguments into a single argument by putting the surrounding double quotes - this speeds up the -mdoc processing drastically (of course if used systematically).
Use the new features of -mdoc: exact -width specifiers, .In macro as an ``.Fd #include'' replacement.
|
79852 |
18-Jul-2001 |
sheldonh |
Remove an example of bad sentence breaking style.
|
79757 |
15-Jul-2001 |
dd |
Remove whitespace at EOL.
|
75869 |
23-Apr-2001 |
ru |
The semantics of the .Os call has been changed. For CURRENT, this currently implies the default argument of "FreeBSD 5.0".
|
75595 |
17-Apr-2001 |
ru |
mdoc.samples(7) is superseded by mdoc(7).
|
75228 |
05-Apr-2001 |
mpp |
We don't use the "pseudo-device" configuration option any longer, so update the example to use the correct definition.
Add an example for documenting kernel compile options, along with a small example of how to reference them in the main text of the man page (I.e. the .Dv macro).
Inspired-by: a brief exchange I saw in in the commit messages mail
|
73088 |
26-Feb-2001 |
ru |
.St -ansiC -> .St -isoC
|
71895 |
01-Feb-2001 |
ru |
mdoc(7) police: split punctuation characters + misc fixes.
|
70015 |
14-Dec-2000 |
ru |
mdoc(7) police: removed history info from the .Os FreeBSD call.
|
69052 |
22-Nov-2000 |
ru |
mdoc(7) police: Er macro usage cleanup.
|
68960 |
20-Nov-2000 |
ru |
mdoc(7) police: use the new features of the Nm macro.
|
59541 |
23-Apr-2000 |
phantom |
Suggest to use .Lb macro in 2nd/3rd section manpages.
|
54340 |
08-Dec-1999 |
mpp |
Make share/examples/mdoc and share/misc/mdoc.template internally consistent, and consistent with mdoc(7) and mdoc.samples(7).
PR: doc/15352, doc/15353
|
50535 |
28-Aug-1999 |
mpp |
Add $FreeBSD$ lines to these example man pages, along with a note that says all man pages should contain a FreeBSD revision control id to make it easier for translation teams.
|
34984 |
01-Apr-1998 |
charnier |
.Sh AUTHOR -> .Sh AUTHORS.
|
30069 |
03-Oct-1997 |
jkh |
Correct typo. PR: 4681 Submitted by: Masahiro Sekiguchi <seki@sysrap.cs.fujitsu.co.jp>
|
24525 |
02-Apr-1997 |
mpp |
Remove some garbage text.
|
24066 |
20-Mar-1997 |
mpp |
Use the .An macro in the AUTHOR section.
|
24056 |
19-Mar-1997 |
mpp |
Update to use the .Rv macro now that I know it exists :-).
|
23199 |
28-Feb-1997 |
bde |
Synced with the C example copyright. Cosmetic except for removing clause 3, which was removed on 1996/08/03 in the C example.
|
22853 |
17-Feb-1997 |
mpp |
These will appear in 2.2, not 3.0.
Pointed out by: wosch
|
22698 |
14-Feb-1997 |
jmg |
some stylistic changes... "you name here" and "you name" to "your name"
2.2 Candidate
|
21453 |
09-Jan-1997 |
mpp |
Update the copyright notices to match our bsd-copyright example.
|
21449 |
09-Jan-1997 |
mpp |
Add some real example diagnostics to example.[14]
Add all of the possible errno's to example.3.
Show examples of the .Bx (BSD) and .At (AT&T UNIX) macros in the various HISTORY sections.
Add some .Rs/.Re (used for referencing things other than man pages) in the SEE ALSO sections.
Suggested by: wollman
|
21239 |
02-Jan-1997 |
mpp |
Correct one minor style point.
|
21235 |
02-Jan-1997 |
mpp |
Moved these from /usr/share/misc/mdoc to /usr/share/examples/mdoc, since it seemed like a better place, and the makefiles for /usr/share/examples didn't need to be fussed with.
The old stuff can be removed from the Attic.
|