blob: 27098444425a031b84afd67c0e97075f7c45976e (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
|
.\"
.\" mdoc validate manual page.
.\" (C) 2008 Novell, Inc.
.\" Author:
.\" Jonathan Pryor (jpryor@novell.com)
.\"
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.TH "mdoc-validate" 1
.SH NAME
mdoc validate \- Validate XML documents against a schema
.SH SYNOPSIS
.B mdoc validate
[OPTIONS]*
PATHS+
.SH DESCRIPTION
\fBmdoc validate\fR validates the specified \fIPATHS\fR against a specified
format schema.
.SH OPTIONS
.TP
\fB\-\-format\fR=\fIFORMAT\fR
The documentation format to validate \fIPATHS\fR against. Supported formats
include: \fIecma\fR.
.Sp
See the \fIFORMATS\fR section below for more information about these formats.
.Sp
The default format (if none is specified) is \fIecma\fR.
.TP
\fB\-h\fR, \fB\-?\fR, \fB\-\-help\fR
Display a help message and exit.
.SH FORMATS
The following documentation formats are supported:
.SS ecma
The \fIMono ECMA Documentation Format\fR validates all output generated by
\fBmdoc-update\fR(1) against an XML schema, including the \fIindex.xml\fR,
\fIns-*.xml\fR, and \fINamespaceName/TypeName.xml\fR files.
.PP
See \fBmdoc\fR(5) for details about this file format.
.SH EXAMPLES
To validate the \fBmdoc-update\fR(1) output stored within a directory (and all
documentation within that directory, recursively), use:
.nf
mdoc validate /path/to/ecma/docs
.fi
.PP
.SH MAILING LISTS
.TP
Visit http://lists.ximian.com/mailman/listinfo/mono-docs-list for details.
.SH WEB SITE
Visit http://www.mono-project.com/mdoc for details
|