summaryrefslogtreecommitdiff
path: root/src/engine/SCons/Tool/rpcgen.xml
diff options
context:
space:
mode:
Diffstat (limited to 'src/engine/SCons/Tool/rpcgen.xml')
-rw-r--r--src/engine/SCons/Tool/rpcgen.xml73
1 files changed, 58 insertions, 15 deletions
diff --git a/src/engine/SCons/Tool/rpcgen.xml b/src/engine/SCons/Tool/rpcgen.xml
index f27cd76..33b66be 100644
--- a/src/engine/SCons/Tool/rpcgen.xml
+++ b/src/engine/SCons/Tool/rpcgen.xml
@@ -1,20 +1,41 @@
+<?xml version="1.0" encoding="UTF-8"?>
<!--
-Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013 The SCons Foundation
+Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014 The SCons Foundation
This file is processed by the bin/SConsDoc.py module.
See its __doc__ string for a discussion of the format.
-->
+
+<!DOCTYPE sconsdoc [
+<!ENTITY % scons SYSTEM '../../../../doc/scons.mod'>
+%scons;
+<!ENTITY % builders-mod SYSTEM '../../../../doc/generated/builders.mod'>
+%builders-mod;
+<!ENTITY % functions-mod SYSTEM '../../../../doc/generated/functions.mod'>
+%functions-mod;
+<!ENTITY % tools-mod SYSTEM '../../../../doc/generated/tools.mod'>
+%tools-mod;
+<!ENTITY % variables-mod SYSTEM '../../../../doc/generated/variables.mod'>
+%variables-mod;
+]>
+
+<sconsdoc xmlns="http://www.scons.org/dbxsd/v1.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">
+
<tool name="rpcgen">
<summary>
+<para>
Sets construction variables for building with RPCGEN.
+</para>
</summary>
<sets>
-RPCGEN
-RPCGENFLAGS
-RPCGENCLIENTFLAGS
-RPCGENHEADERFLAGS
-RPCGENSERVICEFLAGS
-RPCGENXDRFLAGS
+<item>RPCGEN</item>
+<item>RPCGENFLAGS</item>
+<item>RPCGENCLIENTFLAGS</item>
+<item>RPCGENHEADERFLAGS</item>
+<item>RPCGENSERVICEFLAGS</item>
+<item>RPCGENXDRFLAGS</item>
</sets>
<uses>
</uses>
@@ -22,116 +43,138 @@ RPCGENXDRFLAGS
<builder name="RPCGenClient">
<summary>
+<para>
Generates an RPC client stub (<filename>_clnt.c</filename>) file
from a specified RPC (<filename>.x</filename>) source file.
Because rpcgen only builds output files
in the local directory,
the command will be executed
in the source file's directory by default.
+</para>
-<example>
+<example_commands>
# Builds src/rpcif_clnt.c
env.RPCGenClient('src/rpcif.x')
-</example>
+</example_commands>
</summary>
</builder>
<builder name="RPCGenHeader">
<summary>
+<para>
Generates an RPC header (<filename>.h</filename>) file
from a specified RPC (<filename>.x</filename>) source file.
Because rpcgen only builds output files
in the local directory,
the command will be executed
in the source file's directory by default.
+</para>
-<example>
+<example_commands>
# Builds src/rpcif.h
env.RPCGenHeader('src/rpcif.x')
-</example>
+</example_commands>
</summary>
</builder>
<builder name="RPCGenService">
<summary>
+<para>
Generates an RPC server-skeleton (<filename>_svc.c</filename>) file
from a specified RPC (<filename>.x</filename>) source file.
Because rpcgen only builds output files
in the local directory,
the command will be executed
in the source file's directory by default.
+</para>
-<example>
+<example_commands>
# Builds src/rpcif_svc.c
env.RPCGenClient('src/rpcif.x')
-</example>
+</example_commands>
</summary>
</builder>
<builder name="RPCGenXDR">
<summary>
+<para>
Generates an RPC XDR routine (<filename>_xdr.c</filename>) file
from a specified RPC (<filename>.x</filename>) source file.
Because rpcgen only builds output files
in the local directory,
the command will be executed
in the source file's directory by default.
+</para>
-<example>
+<example_commands>
# Builds src/rpcif_xdr.c
env.RPCGenClient('src/rpcif.x')
-</example>
+</example_commands>
</summary>
</builder>
<cvar name="RPCGEN">
<summary>
+<para>
The RPC protocol compiler.
+</para>
</summary>
</cvar>
<cvar name="RPCGENCLIENTFLAGS">
<summary>
+<para>
Options passed to the RPC protocol compiler
when generating client side stubs.
These are in addition to any flags specified in the
&cv-link-RPCGENFLAGS;
construction variable.
+</para>
</summary>
</cvar>
<cvar name="RPCGENFLAGS">
<summary>
+<para>
General options passed to the RPC protocol compiler.
+</para>
</summary>
</cvar>
<cvar name="RPCGENHEADERFLAGS">
<summary>
+<para>
Options passed to the RPC protocol compiler
when generating a header file.
These are in addition to any flags specified in the
&cv-link-RPCGENFLAGS;
construction variable.
+</para>
</summary>
</cvar>
<cvar name="RPCGENSERVICEFLAGS">
<summary>
+<para>
Options passed to the RPC protocol compiler
when generating server side stubs.
These are in addition to any flags specified in the
&cv-link-RPCGENFLAGS;
construction variable.
+</para>
</summary>
</cvar>
<cvar name="RPCGENXDRFLAGS">
<summary>
+<para>
Options passed to the RPC protocol compiler
when generating XDR routines.
These are in addition to any flags specified in the
&cv-link-RPCGENFLAGS;
construction variable.
+</para>
</summary>
</cvar>
+
+</sconsdoc> \ No newline at end of file