File: mdassembler.1

package info (click to toggle)
mono 5.18.0.240%2Bdfsg-3
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 1,253,216 kB
  • sloc: cs: 10,925,936; xml: 2,804,987; ansic: 643,970; cpp: 120,384; perl: 59,272; asm: 21,383; sh: 20,162; makefile: 18,157; python: 4,715; pascal: 924; sql: 859; sed: 16; php: 1
file content (259 lines) | stat: -rw-r--r-- 5,681 bytes parent folder | download | duplicates (5)
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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
.\" 
.\" mdassembler manual page.
.\" (C) 2006 Jonathan Pryor
.\" Author:
.\"   Jonathan Pryor (jonpryor@vt.edu)
.\"
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.TH "mdassembler" 1
.SH NAME
mdassembler \- Compile documentation for use in monodoc browser
.SH SYNOPSIS
.B mdassembler
OPTIONS*
DIRS+
.SH DESCRIPTION
\fImdassembler\fR has been obsoleted by \fBmdoc\fR(1).  See the
\fBmdoc-assemble\fR(1) man page.
.PP
.I mdassembler
is a program that creates 
.I .tree
and 
.I .zip
files for use in the
.B monodoc
documentation browser.
.PP
The 
.I .tree
and
.I .zip
files are copied into monodoc's 
.I sources
directory, and reside with a 
.I .source
file which is used by 
.B monodoc
to specify where the documentation should be displayed.
The 
.I .source
file's 
.I /monodoc/source/@basefile
attribute specifies the filename prefix for the documentation files.  This
must be the same prefix as used with the 
.B \-\-out
parameter.
.PP
.SH OPTIONS
.TP
.I \-\-ecma
The documentation found within 
.I DIRS
is in the Mono ECMA documentation format.
See the 
.B Mono ECMA Documentation Format
section below.
.TP
.I \-\-ecmaspec
The documentation found within 
.I DIRS
is in the ECMA Specification documentation format.
See the 
.B Mono ECMA Specification Documentation Format
section below.
.TP
.I \-\-error
The documentation found within
.I DIRS
is in "error" format.
See the 
.B Error Documentation Format
section below.
.TP
.I \-\-help
Show program argument information.
.TP
.I \-\-man
The documentation found within
.I DIRS
is in man page format.
See the 
.B Man Page Documentation Format
section below.
.TP
.I \-o, \-\-out PREFIX
Specify the output file prefix.
.B mdassembler
creates the files
.I PREFIX.zip
and 
.I PREFIX.tree
\&.
.TP
.I \-\-simple
The documentation found within
.I DIRS
is in "simple" format.
See the 
.B Simple Documentation Format
section below.
.TP
.I \-\-xhtml, \-\-hb
The documentation found within
.I DIRS
is in XHTML format.
See the 
.B XHTML Documentation Format
section below.
.PP
.SH "FORMATS"
The following documentation formats are supported:
.SS Mono ECMA Documentation Format
An XML documentation format with one file per type.
.PP
See the \fBmdoc\fR(5) man page for more information.
.SS Mono ECMA Specification Documentation Format
This is not the format you're looking for.
.PP
This is the format used to represent the ECMA-334 (C#) standard within 
\fBmonodoc\fR.  It is not used to display class library documentation; 
for class library
documentation, use the
.B \-\-ecma
format.
.SS Error Documentation Format
Used to present detailed error messages, and is used in 
\fBmonodoc\fR's "C# Compiler Error Reference"
tree.  
.I DIRS
is not a directory, but is instead a configuration file, containing the XML:

.nf
    <ErrorProviderConfig>
        <FilesPath>../../mcs/errors</FilesPath>
        <Match>cs????*.cs</Match>
        <ErrorNumSubstringStart>2</ErrorNumSubstringStart>
        <ErrorNumSubstringLength>4</ErrorNumSubstringLength>
        <FriendlyFormatString>CS{0:0###}</FriendlyFormatString>
    </ErrorProviderConfig>
.fi

.I /ErrorProviderConfig/FilesPath
specifies where to look for files,
.I /ErrorProviderConfig/Match
specifies the filename pattern to look for within 
\fI/ErrorProviderConfig/FilesPath\fR,
.I /ErrorProviderConfig/ErrorNumSubstringStart
and
.I /ErrorProviderConfig/ErrorNumSubstringLength
control which portion of the filename is used as the error number, and
.I /ErrorProviderConfig/FriendlyFormatString
controls how the formatting/display of the node in the 
.B monodoc
tree.
.PP
For each file found, it is converted to HTML with C# syntax coloring applied.
.SS Simple Documentation Format
Converts text files into HTML by translating each newline into an HTML
.I <br>
element.
.SS Man Page Documentation Format
Converts man pages into HTML for display.
.SS XHTML Documentation Format
Copies the XHTML file as-is.
.SH EXAMPLES
To install your documenation for use with monodoc:
.TP
.I Create a PREFIX.source file
with the contents:
.nf

<?xml version="1.0"?>
<monodoc>
  <source provider="FORMAT" basefile="PREFIX" path="PATH"/>
</monodoc>

.fi
where FORMAT is the documentation format contained within the 
.I PREFIX.tree
file, e.g. 
\fIecma\fR, or \fIsimple\fR.
.I PREFIX is the basename of the 
.I .tree
and
.I .zip
files that 
.B mdassembler
creates.
.I PATH
is the "path" in the monodoc tree that should contain the documentation.
See the 
.I @prefix@/lib/monodoc/monodoc.xml
file for a list of PATH values
(the
.I //node/@name
values).
.sp
See also: http://www.mono-project.com/docs/tools+libraries/tools/monodoc/generating-documentation/
.TP
.I Create your documentation
See also the
.BR monodocer (1)
man page, e.g.
.nf

	monodocer -assembly:foo.dll -path:foo/en

.fi
.TP
.I Assemble the documentation
.nf

	mdassembler --ecma foo/en PREFIX

.fi
Make sure that you use the same
.I PREFIX
here as you did above.
.TP
.I Install the documentation by using the command
.nf

	cp PREFIX.source PREFIX.tree PREFIX.zip \\
	`pkg-config monodoc --variable=sourcesdir`

.fi
(Note the backticks used in the 
.B pkg-config
command!)
This copies the
.I .source
,
.I .tree
, and 
.I .zip
files into the 
.B monodoc
.I sources
directory, which will allow
.B monodoc
to display the documentation.
.SH SEE ALSO
\fBmdcs2ecma\fR(1), 
\fBmdnormalizer\fR(1), 
\fBmdoc\fR(1), 
\fBmdoc-assemble\fR(1), 
\fBmdvalidator\fR(1), 
\fBmonodocer\fR(1), 
\fBmonodocs2html\fR(1)
.SH MAILING LISTS
.TP
Visit http://lists.ximian.com/mailman/listinfo/mono-docs-list for details.
.SH WEB SITE
See also: http://www.mono-project.com
and
http://www.mono-project.com/docs/tools+libraries/tools/mdassembler/