summaryrefslogtreecommitdiffstatshomepage
diff options
context:
space:
mode:
authorKristaps Dzonsons <kristaps@bsd.lv>2009-10-26 10:36:46 +0000
committerKristaps Dzonsons <kristaps@bsd.lv>2009-10-26 10:36:46 +0000
commit9d6a888edb5abd01db8123afa74bc2405f0a9167 (patch)
treeff1f54162635d932a03ad8081a655bd9fcf42039
parentaae9031298fb0d0238d16af6152673e7a820c0d5 (diff)
downloadmandoc-9d6a888edb5abd01db8123afa74bc2405f0a9167.tar.gz
mandoc-9d6a888edb5abd01db8123afa74bc2405f0a9167.tar.zst
mandoc-9d6a888edb5abd01db8123afa74bc2405f0a9167.zip
Fix to segfault in ordering Rs blocks (d'oh!).VERSION_1_9_11
Version: 1.9.11.
-rw-r--r--Makefile2
-rw-r--r--man.761
-rw-r--r--mdoc_action.c7
3 files changed, 64 insertions, 6 deletions
diff --git a/Makefile b/Makefile
index 80f9b445..981f8fe5 100644
--- a/Makefile
+++ b/Makefile
@@ -9,7 +9,7 @@ INSTALL_DATA = install -m 0444
INSTALL_LIB = install -m 0644
INSTALL_MAN = $(INSTALL_DATA)
-VERSION = 1.9.10
+VERSION = 1.9.11
VDATE = 26 October 2009
VFLAGS = -DVERSION="\"$(VERSION)\""
diff --git a/man.7 b/man.7
index ffdbdf39..5c2ac3a2 100644
--- a/man.7
+++ b/man.7
@@ -1,4 +1,4 @@
-.\" $Id: man.7,v 1.40 2009/10/24 05:45:04 kristaps Exp $
+.\" $Id: man.7,v 1.41 2009/10/26 10:36:46 kristaps Exp $
.\"
.\" Copyright (c) 2009 Kristaps Dzonsons <kristaps@kth.se>
.\"
@@ -14,7 +14,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: October 24 2009 $
+.Dd $Mdocdate: October 26 2009 $
.Dt MAN 7
.Os
.
@@ -237,6 +237,63 @@ The \efBfoo\efR utility processes files...
\&.\e\*q .SH BUGS
\&.\e\*q .SH SECURITY CONSIDERATIONS
.Ed
+.Pp
+The sections in a
+.Nm
+document are conventionally ordered as they appear above. Sections
+should be composed as follows:
+.Bl -tag -width Ds -offset Ds
+.It NAME
+The name(s) and a short description of the documented material. The
+syntax for this is generally as follows:
+.Pp
+.D1 \efBname\efR \e(en description
+.It LIBRARY
+The name of the library containing the documented material, which is
+assumed to be a function in a section 2 or 3 manual. For functions in
+the C library, this may be as follows:
+.Pp
+.D1 Standard C Library (libc, -lc)
+.It SYNOPSIS
+Documents the utility invocation syntax, function call syntax, or device
+configuration.
+.Pp
+For the first, utilities (sections 1, 6, and 8), this is
+generally structured as follows:
+.Pp
+.D1 \efBname\efR [-\efBab\efR] [-\efBc\efR\efIarg\efR] \efBpath\efR...
+.Pp
+For the second, function calls (sections 2, 3, 9):
+.Pp
+.D1 \. Ns Sx \&B No char *name(char *\efIarg\efR);
+.Pp
+And for the third, configurations (section 4):
+.Pp
+.D1 \. Ns Sx \&B No name* at cardbus ? function ?
+.Pp
+Manuals not in these sections generally don't need a SYNOPSIS.
+.It DESCRIPTION
+This expands upon the brief, one-line description in NAME. It usually
+contains a break-down of the options (if documenting a command).
+.It IMPLEMENTATION NOTES
+Implementation-specific notes should be kept here. This is useful when
+implementing standard functions that may have side effects or notable
+algorithmic implications.
+.It EXIT STATUS
+.It RETURN VALUES
+.It ENVIRONMENT
+.It FILES
+.It EXAMPLES
+.It DIAGNOSTICS
+.It ERRORS
+.It SEE ALSO
+.It STANDARDS
+.It HISTORY
+.It AUTHORS
+.It CAVEATS
+.It BUGS
+.It SECURITY CONSIDERATIONS
+.El
.
.
.Sh MACRO SYNTAX
diff --git a/mdoc_action.c b/mdoc_action.c
index 709701d4..ed1e39aa 100644
--- a/mdoc_action.c
+++ b/mdoc_action.c
@@ -1,4 +1,4 @@
-/* $Id: mdoc_action.c,v 1.44 2009/10/26 04:09:45 kristaps Exp $ */
+/* $Id: mdoc_action.c,v 1.45 2009/10/26 10:36:46 kristaps Exp $ */
/*
* Copyright (c) 2008, 2009 Kristaps Dzonsons <kristaps@kth.se>
*
@@ -192,7 +192,7 @@ static const struct actions mdoc_actions[MDOC_MAX] = {
{ NULL, NULL }, /* %U */
};
-#define RSORD_MAX 13
+#define RSORD_MAX 14
static const int rsord[RSORD_MAX] = {
MDOC__A,
@@ -207,7 +207,8 @@ static const int rsord[RSORD_MAX] = {
MDOC__Q,
MDOC__D,
MDOC__O,
- MDOC__C
+ MDOC__C,
+ MDOC__U
};