[Pkg-mono-svn-commits] rev 3803 - in monodoc/trunk/debian: . man patches

Sun Nov 23 18:56:43 UTC 2008

Author: hanska-guest
Date: 2008-11-23 18:56:43 +0000 (Sun, 23 Nov 2008)
New Revision: 3803

Added:
   monodoc/trunk/debian/man/mono-config.5
Modified:
   monodoc/trunk/debian/changelog
   monodoc/trunk/debian/patches/05-backport_2.2_nodes_handling.patch
Log:
debian/man/mono-config.5 added
Backport complete!

Modified: monodoc/trunk/debian/changelog
===================================================================

--- monodoc/trunk/debian/changelog	2008-11-23 18:00:25 UTC (rev 3802)
+++ monodoc/trunk/debian/changelog	2008-11-23 18:56:43 UTC (rev 3803)
@@ -25,10 +25,11 @@
   * debian/patches:
     + 05-backport_2.2_nodes_handling.patch added, implements new way of
       handling monodoc.xml and documentation nodes
+  * debian/man/mono-config.5 added
   * Group Policy:
     + implement get-orig-source target in debian/rules
 
- -- David Paleino <d.paleino at gmail.com>  Sun, 23 Nov 2008 18:19:49 +0100
+ -- David Paleino <d.paleino at gmail.com>  Sun, 23 Nov 2008 19:56:11 +0100
 
 monodoc (1.9-2) unstable; urgency=low
 

Added: monodoc/trunk/debian/man/mono-config.5
===================================================================
--- monodoc/trunk/debian/man/mono-config.5	                        (rev 0)
+++ monodoc/trunk/debian/man/mono-config.5	2008-11-23 18:56:43 UTC (rev 3803)
@@ -0,0 +1,133 @@
+.\" 
+.\" mono-config configuration page.
+.\" (C) Ximian, Inc. 
+.\" Author:
+.\"   Miguel de Icaza (miguel at gnu.org)
+.\"   Paolo Molaro (lupus at ximian.com)
+.\"
+.TH Mono "Mono 1.0"
+.SH NAME
+mono-config \- Mono runtime file format configuration
+.SH DESCRIPTION
+The Mono runtime will load configuration data from the
+installation prefix /etc/mono/config file, the ~/.mono/config or from
+the file pointed by the MONO_CONFIG environment variable.
+.PP
+For each assembly loaded a config file with the name:
+/path/to/the/assembly.exe.config is loaded as well as the
+~/.mono/assemblies/ASSEMBLY/ASSEMBLY.EXT.config file. 
+.PP
+This file controls the behavior of the runtime.
+.PP
+The file contains an XML-like file with various sections, all of them
+contained inside a 
+.B<configuration> 
+section (It actually uses GMarkup
+to parse the file).
+.PP
+This page describes the Unix-specific and Mono-specific extensions to
+the configuration file;   For complete details, see the
+http://www.mono-project.com/Config web page.
+.SH <dllmap> directive
+You use the dllmap directive to map shared libraries referenced by
+P/Invoke in your assemblies to a different shared library.
+.PP
+This is typically used to map Windows libraries to Unix library names.
+The 
+.B dllmap
+element takes two attributes:
+.TP
+.I dll
+This should be the same string used in the DllImport attribute, optionally
+prefixed with "i:" to indicate that the string must be matched in a
+case-insensitive way
+.TP
+.I target
+This should be the name of the library where the function can be found: 
+this name should be suitable for use with the platform native shared library 
+loading routines (dlopen etc.), so you may want to check the manpages for that, too.
+.SH <dllentry> directive
+This directive can be used to map a specific dll/function pair to a different
+library and also a different function name. It should appear inside a
+.B dllmap
+element with only the dll attribute specified.
+.PP
+The
+.B dllentry
+element takes 3 attributes:
+.TP
+.I dll
+This is the target library, where the function can be found.
+.TP
+.I name
+This is the name of the function as it appears in the metadata: it is the name 
+of the P/Invoke method.
+.TP
+.I target
+This is the name of the function to lookup instead of the name specified in the 
+P/Invoke method.
+.SH Mapping based on operating system and cpu
+Both the
+.B dllmap
+and the
+.B dllentry
+elements allow the following two attributes which make it easy to use a single
+configuration file and support multiple operating systems and architectures with
+different mapping requirements:
+.TP
+.I os
+This is the name of the operating system for which the mapping should be applied.
+Allowed values are: linux, osx, solaris, freebsd, openbsd, netbsd, windows, aix, hpux.
+.TP
+.I cpu
+This is the name of the architecture for which the mapping should be applied.
+Allowed values are: x86, x86-64, sparc, ppc, s390, s390x, arm, mips, alpha, hppa, ia64.
+.PP
+The attribute value for both attributes can be a comma-separated list of the allowed
+values. Additionally, the first character may be a
+.I '!'
+to reverse the meaning. An attribute value of "!windows,osx", for example, would mean
+that the entry is considered on all operating systems, except on Windows and OS X.
+No spaces are allowed in any part of the value.
+.PP
+Note that later entries will override the entries defined earlier in the file.
+.SH EXAMPLES
+The following example maps references to the `cygwin1.dll' shared
+library to the `libc.so.6' file.  
+.nf
+<configuration>
+	<dllmap dll="i:cygwin1.dll" target="libc.so.6"/>
+</configuration>
+.fi
+The library name in the DllImport attribute is allowed to be in any
+case variant, like the following examples:
+.nf
+.nf
+	[DllImport ("cygwin1.dll")]
+	[DllImport ("Cygwin1.dll")]
+	[DllImport ("cygwiN1.Dll")]
+.fi
+.PP
+This one maps the following C# method:
+.nf
+	[DllImport ("libc")]
+	static extern void somefunction ();
+.fi
+to
+.B differentfunction
+in
+.B libdifferent.so
+, but to the same function in the library
+.B libanother.so
+when running under the Solaris and FreeBSD operating systems.
+.nf
+<configuration>
+	<dllmap dll="libc">
+		<dllentry dll="libdifferent.so" name="somefunction" target="differentfunction" />
+		<dllentry os="solaris,freebsd" dll="libanother.so" name="somefunction" target="differentfunction" />
+	</dllmap>
+</configuration>
+.fi
+
+.SH SEE ALSO
+.BR mono(1), monodis(1), mint(1)

Modified: monodoc/trunk/debian/patches/05-backport_2.2_nodes_handling.patch
===================================================================
--- monodoc/trunk/debian/patches/05-backport_2.2_nodes_handling.patch	2008-11-23 18:00:25 UTC (rev 3802)
+++ monodoc/trunk/debian/patches/05-backport_2.2_nodes_handling.patch	2008-11-23 18:56:43 UTC (rev 3803)
@@ -251,9 +251,13 @@
  				continue;
 --- /dev/null
 +++ monodoc-2.0/class/mono-file-formats.config
-@@ -0,0 +1,5 @@
+@@ -0,0 +1,9 @@
 +<?xml version="1.0"?>
 +<manpages>
-+  <manpage name="mdoc(5)"               page="../../mono/man/mdoc.5" />
-+  <manpage name="mono-config(5)"        page="../../mono/man/mono-config.5" />
++  <manpage name="mdoc(5)"               page="../man/mdoc.5" />
++  <!--
++    This is because the old sources didn't have mono-config.5 anywhere.
++                                                       David Paleino (hanska)
++  -->
++  <manpage name="mono-config(5)"        page="../debian/man/mono-config.5" />
 +</manpages>


