Martin Baulig a3ed5ef01f Add .gitignore. vor 17 Jahren
..
deploy 1cbad8abc3 Create .gitignore's. vor 17 Jahren
sources 3f4241e20b Some doc work vor 17 Jahren
svgs 1ad4fb9420 The drawings for the /Compacting_GC page vor 19 Jahren
.gitignore a3ed5ef01f Add .gitignore. vor 17 Jahren
AgilityPack.dll 9530c52568 * Makefile.am: Build `docs` after `runtime`, so that it can depend vor 17 Jahren
ChangeLog 41c54c44fc 2009-02-12 Zoltan Varga <[email protected]> vor 17 Jahren
Makefile.am 41c54c44fc 2009-02-12 Zoltan Varga <[email protected]> vor 17 Jahren
README a37699ee22 2009-02-12 Zoltan Varga <[email protected]> vor 17 Jahren
TODO 9530c52568 * Makefile.am: Build `docs` after `runtime`, so that it can depend vor 17 Jahren
abc-removal.txt 2279f44099 Make docs consistent vor 18 Jahren
api-style.css 9530c52568 * Makefile.am: Build `docs` after `runtime`, so that it can depend vor 17 Jahren
assembly-bundle 45fdd8f3bd Formatting changes vor 22 Jahren
check-coverage 9530c52568 * Makefile.am: Build `docs` after `runtime`, so that it can depend vor 17 Jahren
check-exports 12a2762547 * check, Makefile.am (EXTRA_DIST): Rename to check-exports. This was vor 17 Jahren
convert.cs 9530c52568 * Makefile.am: Build `docs` after `runtime`, so that it can depend vor 17 Jahren
current-api 9530c52568 * Makefile.am: Build `docs` after `runtime`, so that it can depend vor 17 Jahren
docs.make f76dcea883 Remove unnecessary rebuilds of the html directory vor 17 Jahren
documented 9530c52568 * Makefile.am: Build `docs` after `runtime`, so that it can depend vor 17 Jahren
embedded-api 1a3e73350b Add notice vor 19 Jahren
exceptions 45fdd8f3bd Formatting changes vor 22 Jahren
exdoc 461f3d7780 * Makefile.am: Clean up for srcdir != builddir. vor 17 Jahren
file-share-modes 7d99c5cd37 File share mode notes vor 21 Jahren
gc-issues b1a7c0e3f7 Added the docs dir to the dist (with a new doc on GC issues). vor 24 Jahren
gc-variables-in-c 51127666ef Precise GC doc updates. vor 19 Jahren
generic-sharing c98c6ed66a 2008-09-18 Mark Probst <[email protected]> vor 17 Jahren
glossary.txt 416745b435 Add vor 18 Jahren
ignore 9530c52568 * Makefile.am: Build `docs` after `runtime`, so that it can depend vor 17 Jahren
internal-calls a931f76886 Documentation updates. vor 19 Jahren
ir-desc fea5be50f6 Doc update vor 21 Jahren
jit-imt 857199f156 More IMT doc updates. vor 18 Jahren
jit-thoughts fcafc32fbc *** empty log message *** vor 23 Jahren
jit-trampolines cb1d0a5493 Update vor 17 Jahren
local-regalloc.txt 5a710fa941 New compilation engine for Mono vor 23 Jahren
magic.diff 1b91d218c4 magic file(1) patch. vor 20 Jahren
mini-doc.txt aa957b6a39 Align options, update doc vor 21 Jahren
mini-porting.txt db9d50eab1 2008-12-12 Mark Probst <[email protected]> vor 17 Jahren
mono-api-metadata.html 9530c52568 * Makefile.am: Build `docs` after `runtime`, so that it can depend vor 17 Jahren
mono-file-formats.config 217ddc29c4 * docs.make, Makefile.am: Build mono-file-formats{.tree,.zip}, vor 17 Jahren
mono-file-formats.source 093543f1e7 * mono-file-formats.source, mono-tools.source: Place these under the vor 17 Jahren
mono-tools.config 217ddc29c4 * docs.make, Makefile.am: Build mono-file-formats{.tree,.zip}, vor 17 Jahren
mono-tools.source 093543f1e7 * mono-file-formats.source, mono-tools.source: Place these under the vor 17 Jahren
mono_handle_d 8341073202 vor 23 Jahren
monoapi.source 9530c52568 * Makefile.am: Build `docs` after `runtime`, so that it can depend vor 17 Jahren
new-regalloc ba3f5b85ca New regalloc design. vor 21 Jahren
object-layout 04bbd9582f documentation updates vor 24 Jahren
opcode-decomp.txt 5a710fa941 New compilation engine for Mono vor 23 Jahren
precise-gc 51127666ef Precise GC doc updates. vor 19 Jahren
produce-lists 9530c52568 * Makefile.am: Build `docs` after `runtime`, so that it can depend vor 17 Jahren
public 9530c52568 * Makefile.am: Build `docs` after `runtime`, so that it can depend vor 17 Jahren
public-api 9530c52568 * Makefile.am: Build `docs` after `runtime`, so that it can depend vor 17 Jahren
release-notes-1.0.html 022f2a162c Start vor 21 Jahren
remoting d3b7ce10a8 Added information about the cross-app domain optimizations in the remoting doc. vor 21 Jahren
ssapre.txt fdd3f0d541 I forgot to save at the right time :-( Now the file is complete! vor 21 Jahren
stack-alignment ee1efbccbd *** empty log message *** vor 24 Jahren
stack-overflow.txt 8cdc270b16 Add vor 18 Jahren
threading 5388febb0d Thread doc vor 23 Jahren
toc.xml 9530c52568 * Makefile.am: Build `docs` after `runtime`, so that it can depend vor 17 Jahren
tree-mover.txt b37add239c 2006-03-31 Massimiliano Mantione <[email protected]> vor 20 Jahren
unmanaged-calls 04bbd9582f documentation updates vor 24 Jahren
wapi 9530c52568 * Makefile.am: Build `docs` after `runtime`, so that it can depend vor 17 Jahren

README

Documentation is now maintained on the mono wiki:

http://www.mono-project.com/Mono:Runtime:Documentation

Older documents or documents which were not yet migrated to the wiki are kept here.

* Scripts to maintain the Mono VM internal API

Layout
------

sources/
mono-api-*.html

Contains the various source files, each source file
contains HTML, and a line for each API call like this:

mono_something



The format is static, notice that the tools actually search
for the above format and process that (both the tools here,
as well as the upcoming Monodoc tools and index creation
tools).

The files can contain any ammount of extra information.

The documentation from the source code is then merged with
these files and the header/footer information to produce
the deploy directory.

deploy/

Scripts produce a ready-to-use set of XHTML files that can
be either fed into a monodoc XHTML provider or can be published
directly on the web.

PROGRAMS
--------
* check-coverage

Run this script every once in a while to make sure that a
public symbol that has been added to Mono has a corresponding
section on the mono-vm-api.html

This works by looking for the

APICALL

pattern on the
HTML file.

* produce-lists

Produces the public-api and wapi files that contain the public
libmono API.

* exdoc

Extracts the embedded documentation from the sources.

* check

This script is used to verify which routines are missing inline
documentation, usage:

check mono/metadata/*.c

* convert.cs

Converts an HTML file into a valid XML document, uses the
AgilityPack.dll. The sources to this DLL live in GNOME CVS
module beagle/Filters/AgilityPack.

A binary is shipped for our convenience.

DATAFILES:
---------

ignore

Contains the list of public symbols that should be
ignored, they come from tests for example, or are known
to be exposed.

This is consumed by produce-lists

public-api
wapi
These two are produced by the produce-lists script
and it documents all the public methods.