diff options
author | Matthieu Herrb <matthieu@cvs.openbsd.org> | 2014-04-13 11:57:05 +0000 |
---|---|---|
committer | Matthieu Herrb <matthieu@cvs.openbsd.org> | 2014-04-13 11:57:05 +0000 |
commit | f28aaabf9d3e9ba2cbb498e5d65f44526cdc4eae (patch) | |
tree | 25aeebe0980333cc2f61d1d9db380a6a920af75e /lib/libxtrans/doc | |
parent | eb2ea36e5d60394ae6ad01d97ff18d1f40cbae13 (diff) |
Update to xtrans 1.3.4
Diffstat (limited to 'lib/libxtrans/doc')
-rw-r--r-- | lib/libxtrans/doc/Makefile.in | 432 | ||||
-rw-r--r-- | lib/libxtrans/doc/xtrans.xml | 565 |
2 files changed, 648 insertions, 349 deletions
diff --git a/lib/libxtrans/doc/Makefile.in b/lib/libxtrans/doc/Makefile.in index cb6fe6719..8c912bb86 100644 --- a/lib/libxtrans/doc/Makefile.in +++ b/lib/libxtrans/doc/Makefile.in @@ -1,8 +1,8 @@ -# Makefile.in generated by automake 1.9.6 from Makefile.am. +# Makefile.in generated by automake 1.12.6 from Makefile.am. # @configure_input@ -# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, -# 2003, 2004, 2005 Free Software Foundation, Inc. +# Copyright (C) 1994-2012 Free Software Foundation, Inc. + # This Makefile.in is free software; the Free Software Foundation # gives unlimited permission to copy and/or distribute it, # with or without modifications, as long as this notice is preserved. @@ -15,37 +15,44 @@ @SET_MAKE@ # -# Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved. +# Generate output formats for a single DocBook/XML with/without chapters # -# Permission is hereby granted, free of charge, to any person obtaining a -# copy of this software and associated documentation files (the "Software"), -# to deal in the Software without restriction, including without limitation -# the rights to use, copy, modify, merge, publish, distribute, sublicense, -# and/or sell copies of the Software, and to permit persons to whom the -# Software is furnished to do so, subject to the following conditions: +# Variables set by the calling Makefile: +# shelfdir: the location where the docs/specs are installed. Typically $(docdir) +# docbook: the main DocBook/XML file, no chapters, appendix or image files +# chapters: all files pulled in by an XInclude statement and images. # -# The above copyright notice and this permission notice (including the next -# paragraph) shall be included in all copies or substantial portions of the -# Software. + # -# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL -# THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER -# DEALINGS IN THE SOFTWARE. +# This makefile is intended for Users Documentation and Functional Specifications. +# Do not use for Developer Documentation which is not installed and does not require olink. +# Refer to http://www.x.org/releases/X11R7.6/doc/xorg-docs/ReleaseNotes.html#id2584393 +# for an explanation on documents classification. # -srcdir = @srcdir@ -top_srcdir = @top_srcdir@ VPATH = @srcdir@ +am__make_dryrun = \ + { \ + am__dry=no; \ + case $$MAKEFLAGS in \ + *\\[\ \ ]*) \ + echo 'am--echo: ; @echo "AM" OK' | $(MAKE) -f - 2>/dev/null \ + | grep '^AM OK$$' >/dev/null || am__dry=yes;; \ + *) \ + for am__flg in $$MAKEFLAGS; do \ + case $$am__flg in \ + *=*|--*) ;; \ + *n*) am__dry=yes; break;; \ + esac; \ + done;; \ + esac; \ + test $$am__dry = yes; \ + } pkgdatadir = $(datadir)/@PACKAGE@ -pkglibdir = $(libdir)/@PACKAGE@ pkgincludedir = $(includedir)/@PACKAGE@ -top_builddir = .. +pkglibdir = $(libdir)/@PACKAGE@ +pkglibexecdir = $(libexecdir)/@PACKAGE@ am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd -INSTALL = @INSTALL@ install_sh_DATA = $(install_sh) -c -m 644 install_sh_PROGRAM = $(install_sh) -c install_sh_SCRIPT = $(install_sh) -c @@ -59,36 +66,75 @@ PRE_UNINSTALL = : POST_UNINSTALL = : build_triplet = @build@ host_triplet = @host@ -@ENABLE_DOCS_TRUE@@HAVE_FOP_TRUE@@HAVE_XMLTO_TRUE@am__append_1 = $(doc_sources:.xml=.ps) $(doc_sources:.xml=.pdf) -@ENABLE_DOCS_TRUE@@HAVE_XMLTO_TEXT_TRUE@@HAVE_XMLTO_TRUE@am__append_2 = $(doc_sources:.xml=.txt) +DIST_COMMON = $(am__dist_shelf_DATA_DIST) $(srcdir)/Makefile.am \ + $(srcdir)/Makefile.in $(top_srcdir)/docbook.am +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@am__append_1 = $(docbook:.xml=.html) +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TEXT_TRUE@@HAVE_XMLTO_TRUE@am__append_2 = $(docbook:.xml=.txt) +@ENABLE_DOCS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@am__append_3 = $(docbook:.xml=.pdf) \ +@ENABLE_DOCS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(docbook:.xml=.ps) +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@am__append_4 = $(docbook:.xml=.html.db) \ +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(docbook:.xml=.pdf.db) subdir = doc -DIST_COMMON = $(am__dist_doc_DATA_DIST) $(srcdir)/Makefile.am \ - $(srcdir)/Makefile.in ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) -mkinstalldirs = $(SHELL) $(install_sh) -d +mkinstalldirs = $(install_sh) -d CONFIG_CLEAN_FILES = +CONFIG_CLEAN_VPATH_FILES = +AM_V_P = $(am__v_P_@AM_V@) +am__v_P_ = $(am__v_P_@AM_DEFAULT_V@) +am__v_P_0 = false +am__v_P_1 = : +AM_V_GEN = $(am__v_GEN_@AM_V@) +am__v_GEN_ = $(am__v_GEN_@AM_DEFAULT_V@) +am__v_GEN_0 = @echo " GEN " $@; +am__v_GEN_1 = +AM_V_at = $(am__v_at_@AM_V@) +am__v_at_ = $(am__v_at_@AM_DEFAULT_V@) +am__v_at_0 = @ +am__v_at_1 = SOURCES = DIST_SOURCES = -am__dist_doc_DATA_DIST = xtrans.xml +am__can_run_installinfo = \ + case $$AM_UPDATE_INFO_DIR in \ + n|no|NO) false;; \ + *) (install-info --version) >/dev/null 2>&1;; \ + esac +am__dist_shelf_DATA_DIST = xtrans.xml am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; am__vpath_adj = case $$p in \ $(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \ *) f=$$p;; \ esac; -am__strip_dir = `echo $$p | sed -e 's|^.*/||'`; -am__installdirs = "$(DESTDIR)$(docdir)" "$(DESTDIR)$(docdir)" -dist_docDATA_INSTALL = $(INSTALL_DATA) -docDATA_INSTALL = $(INSTALL_DATA) -DATA = $(dist_doc_DATA) $(doc_DATA) +am__strip_dir = f=`echo $$p | sed -e 's|^.*/||'`; +am__install_max = 40 +am__nobase_strip_setup = \ + srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*|]/\\\\&/g'` +am__nobase_strip = \ + for p in $$list; do echo "$$p"; done | sed -e "s|$$srcdirstrip/||" +am__nobase_list = $(am__nobase_strip_setup); \ + for p in $$list; do echo "$$p $$p"; done | \ + sed "s| $$srcdirstrip/| |;"' / .*\//!s/ .*/ ./; s,\( .*\)/[^/]*$$,\1,' | \ + $(AWK) 'BEGIN { files["."] = "" } { files[$$2] = files[$$2] " " $$1; \ + if (++n[$$2] == $(am__install_max)) \ + { print $$2, files[$$2]; n[$$2] = 0; files[$$2] = "" } } \ + END { for (dir in files) print dir, files[dir] }' +am__base_list = \ + sed '$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;s/\n/ /g' | \ + sed '$$!N;$$!N;$$!N;$$!N;s/\n/ /g' +am__uninstall_files_from_dir = { \ + test -z "$$files" \ + || { test ! -d "$$dir" && test ! -f "$$dir" && test ! -r "$$dir"; } \ + || { echo " ( cd '$$dir' && rm -f" $$files ")"; \ + $(am__cd) "$$dir" && rm -f $$files; }; \ + } +am__installdirs = "$(DESTDIR)$(shelfdir)" "$(DESTDIR)$(shelfdir)" +DATA = $(dist_shelf_DATA) $(shelf_DATA) DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ ADMIN_MAN_DIR = @ADMIN_MAN_DIR@ ADMIN_MAN_SUFFIX = @ADMIN_MAN_SUFFIX@ -AMDEP_FALSE = @AMDEP_FALSE@ -AMDEP_TRUE = @AMDEP_TRUE@ AMTAR = @AMTAR@ AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@ APP_MAN_DIR = @APP_MAN_DIR@ @@ -97,6 +143,7 @@ AUTOCONF = @AUTOCONF@ AUTOHEADER = @AUTOHEADER@ AUTOMAKE = @AUTOMAKE@ AWK = @AWK@ +BASE_CFLAGS = @BASE_CFLAGS@ CC = @CC@ CCDEPMODE = @CCDEPMODE@ CFLAGS = @CFLAGS@ @@ -113,21 +160,12 @@ ECHO_C = @ECHO_C@ ECHO_N = @ECHO_N@ ECHO_T = @ECHO_T@ EGREP = @EGREP@ -ENABLE_DOCS_FALSE = @ENABLE_DOCS_FALSE@ -ENABLE_DOCS_TRUE = @ENABLE_DOCS_TRUE@ EXEEXT = @EXEEXT@ FILE_MAN_DIR = @FILE_MAN_DIR@ FILE_MAN_SUFFIX = @FILE_MAN_SUFFIX@ FOP = @FOP@ GREP = @GREP@ -HAVE_FOP_FALSE = @HAVE_FOP_FALSE@ -HAVE_FOP_TRUE = @HAVE_FOP_TRUE@ -HAVE_STYLESHEETS_FALSE = @HAVE_STYLESHEETS_FALSE@ -HAVE_STYLESHEETS_TRUE = @HAVE_STYLESHEETS_TRUE@ -HAVE_XMLTO_FALSE = @HAVE_XMLTO_FALSE@ -HAVE_XMLTO_TEXT_FALSE = @HAVE_XMLTO_TEXT_FALSE@ -HAVE_XMLTO_TEXT_TRUE = @HAVE_XMLTO_TEXT_TRUE@ -HAVE_XMLTO_TRUE = @HAVE_XMLTO_TRUE@ +INSTALL = @INSTALL@ INSTALL_CMD = @INSTALL_CMD@ INSTALL_DATA = @INSTALL_DATA@ INSTALL_PROGRAM = @INSTALL_PROGRAM@ @@ -139,35 +177,40 @@ LIBS = @LIBS@ LIB_MAN_DIR = @LIB_MAN_DIR@ LIB_MAN_SUFFIX = @LIB_MAN_SUFFIX@ LTLIBOBJS = @LTLIBOBJS@ -MAINT = @MAINT@ -MAINTAINER_MODE_FALSE = @MAINTAINER_MODE_FALSE@ -MAINTAINER_MODE_TRUE = @MAINTAINER_MODE_TRUE@ MAKEINFO = @MAKEINFO@ MAN_SUBSTS = @MAN_SUBSTS@ MISC_MAN_DIR = @MISC_MAN_DIR@ MISC_MAN_SUFFIX = @MISC_MAN_SUFFIX@ +MKDIR_P = @MKDIR_P@ OBJEXT = @OBJEXT@ PACKAGE = @PACKAGE@ PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ PACKAGE_NAME = @PACKAGE_NAME@ PACKAGE_STRING = @PACKAGE_STRING@ PACKAGE_TARNAME = @PACKAGE_TARNAME@ +PACKAGE_URL = @PACKAGE_URL@ PACKAGE_VERSION = @PACKAGE_VERSION@ PATH_SEPARATOR = @PATH_SEPARATOR@ PKG_CONFIG = @PKG_CONFIG@ +PKG_CONFIG_LIBDIR = @PKG_CONFIG_LIBDIR@ +PKG_CONFIG_PATH = @PKG_CONFIG_PATH@ SED = @SED@ SET_MAKE = @SET_MAKE@ SHELL = @SHELL@ +STRICT_CFLAGS = @STRICT_CFLAGS@ STRIP = @STRIP@ STYLESHEET_SRCDIR = @STYLESHEET_SRCDIR@ VERSION = @VERSION@ XMLTO = @XMLTO@ XORG_MAN_PAGE = @XORG_MAN_PAGE@ XORG_SGML_PATH = @XORG_SGML_PATH@ +XSLTPROC = @XSLTPROC@ XSL_STYLESHEET = @XSL_STYLESHEET@ +abs_builddir = @abs_builddir@ +abs_srcdir = @abs_srcdir@ +abs_top_builddir = @abs_top_builddir@ +abs_top_srcdir = @abs_top_srcdir@ ac_ct_CC = @ac_ct_CC@ -am__fastdepCC_FALSE = @am__fastdepCC_FALSE@ -am__fastdepCC_TRUE = @am__fastdepCC_TRUE@ am__include = @am__include@ am__leading_dot = @am__leading_dot@ am__quote = @am__quote@ @@ -179,6 +222,7 @@ build_alias = @build_alias@ build_cpu = @build_cpu@ build_os = @build_os@ build_vendor = @build_vendor@ +builddir = @builddir@ datadir = @datadir@ datarootdir = @datarootdir@ docdir = @docdir@ @@ -207,37 +251,91 @@ program_transform_name = @program_transform_name@ psdir = @psdir@ sbindir = @sbindir@ sharedstatedir = @sharedstatedir@ +srcdir = @srcdir@ sticky_bit_define = @sticky_bit_define@ sysconfdir = @sysconfdir@ target_alias = @target_alias@ -@ENABLE_DOCS_TRUE@doc_sources = xtrans.xml -@ENABLE_DOCS_TRUE@dist_doc_DATA = $(doc_sources) -@ENABLE_DOCS_TRUE@@HAVE_XMLTO_TRUE@doc_DATA = \ -@ENABLE_DOCS_TRUE@@HAVE_XMLTO_TRUE@ $(doc_sources:.xml=.html) \ -@ENABLE_DOCS_TRUE@@HAVE_XMLTO_TRUE@ $(am__append_1) \ -@ENABLE_DOCS_TRUE@@HAVE_XMLTO_TRUE@ $(am__append_2) -@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_FLAGS = \ -@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ -m $(XSL_STYLESHEET) \ -@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam html.stylesheet="$(STYLESHEET_SRCDIR)/xorg.css" - -@ENABLE_DOCS_TRUE@@HAVE_XMLTO_TRUE@CLEANFILES = $(doc_DATA) -@ENABLE_DOCS_TRUE@@HAVE_XMLTO_TRUE@SUFFIXES = .xml .ps .pdf .txt .html +top_build_prefix = @top_build_prefix@ +top_builddir = @top_builddir@ +top_srcdir = @top_srcdir@ + +# Main DocBook/XML files (DOCTYPE book) +@ENABLE_DOCS_TRUE@docbook = xtrans.xml + +# The location where the DocBook/XML files and their generated formats are installed +@ENABLE_DOCS_TRUE@shelfdir = $(docdir) + +# DocBook/XML generated output formats to be installed +@ENABLE_DOCS_TRUE@shelf_DATA = $(am__append_1) $(am__append_2) \ +@ENABLE_DOCS_TRUE@ $(am__append_3) $(am__append_4) + +# DocBook/XML file with chapters, appendix and images it includes +@ENABLE_DOCS_TRUE@dist_shelf_DATA = $(docbook) $(chapters) +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_SEARCHPATH_FLAGS = \ +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --searchpath "$(XORG_SGML_PATH)/X11" \ +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --searchpath "$(abs_top_builddir)" + +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_HTML_OLINK_FLAGS = \ +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam target.database.document=$(XORG_SGML_PATH)/X11/dbs/masterdb.html.xml \ +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam current.docid="$(<:.xml=)" + +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_HTML_STYLESHEET_FLAGS = -x $(STYLESHEET_SRCDIR)/xorg-xhtml.xsl +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_HTML_FLAGS = \ +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_SEARCHPATH_FLAGS) \ +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_HTML_STYLESHEET_FLAGS) \ +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_HTML_OLINK_FLAGS) + +@ENABLE_DOCS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_FO_IMAGEPATH_FLAGS = --stringparam img.src.path=$(abs_builddir)/ +@ENABLE_DOCS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_PDF_OLINK_FLAGS = \ +@ENABLE_DOCS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam target.database.document=$(XORG_SGML_PATH)/X11/dbs/masterdb.pdf.xml \ +@ENABLE_DOCS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam current.docid="$(<:.xml=)" + +@ENABLE_DOCS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_FO_STYLESHEET_FLAGS = -x $(STYLESHEET_SRCDIR)/xorg-fo.xsl +@ENABLE_DOCS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_FO_FLAGS = \ +@ENABLE_DOCS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_SEARCHPATH_FLAGS) \ +@ENABLE_DOCS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_FO_STYLESHEET_FLAGS) \ +@ENABLE_DOCS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_FO_IMAGEPATH_FLAGS) \ +@ENABLE_DOCS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_PDF_OLINK_FLAGS) + + +# Generate documents cross-reference target databases +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_SEARCHPATH_FLAGS = \ +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --path "$(XORG_SGML_PATH)/X11" \ +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --path "$(abs_top_builddir)" + +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_OLINK_FLAGS = \ +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --stringparam targets.filename "$@" \ +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --stringparam collect.xref.targets "only" \ +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --stringparam olink.base.uri "$(@:.db=)" + +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_HTML_FLAGS = \ +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_SEARCHPATH_FLAGS) \ +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_OLINK_FLAGS) \ +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --nonet --xinclude \ +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(STYLESHEET_SRCDIR)/xorg-xhtml.xsl + +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_PDF_FLAGS = \ +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_SEARCHPATH_FLAGS) \ +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_OLINK_FLAGS) \ +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --nonet --xinclude \ +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(STYLESHEET_SRCDIR)/xorg-fo.xsl + +@ENABLE_DOCS_TRUE@CLEANFILES = $(shelf_DATA) all: all-am .SUFFIXES: -.SUFFIXES: .xml .ps .pdf .txt .html -$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__configure_deps) +$(srcdir)/Makefile.in: $(srcdir)/Makefile.am $(top_srcdir)/docbook.am $(am__configure_deps) @for dep in $?; do \ case '$(am__configure_deps)' in \ *$$dep*) \ - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh \ - && exit 0; \ + ( cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh ) \ + && { if test -f $@; then exit 0; else break; fi; }; \ exit 1;; \ esac; \ done; \ - echo ' cd $(top_srcdir) && $(AUTOMAKE) --foreign doc/Makefile'; \ - cd $(top_srcdir) && \ - $(AUTOMAKE) --foreign doc/Makefile + echo ' cd $(top_srcdir) && $(AUTOMAKE) --foreign doc/Makefile'; \ + $(am__cd) $(top_srcdir) && \ + $(AUTOMAKE) --foreign doc/Makefile .PRECIOUS: Makefile Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status @case '$?' in \ @@ -247,80 +345,94 @@ Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ esac; +$(top_srcdir)/docbook.am: $(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh -$(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps) +$(top_srcdir)/configure: $(am__configure_deps) cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh -$(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps) +$(ACLOCAL_M4): $(am__aclocal_m4_deps) cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh -uninstall-info-am: -install-dist_docDATA: $(dist_doc_DATA) +$(am__aclocal_m4_deps): +install-dist_shelfDATA: $(dist_shelf_DATA) @$(NORMAL_INSTALL) - test -z "$(docdir)" || $(mkdir_p) "$(DESTDIR)$(docdir)" - @list='$(dist_doc_DATA)'; for p in $$list; do \ + @list='$(dist_shelf_DATA)'; test -n "$(shelfdir)" || list=; \ + if test -n "$$list"; then \ + echo " $(MKDIR_P) '$(DESTDIR)$(shelfdir)'"; \ + $(MKDIR_P) "$(DESTDIR)$(shelfdir)" || exit 1; \ + fi; \ + for p in $$list; do \ if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \ - f=$(am__strip_dir) \ - echo " $(dist_docDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(docdir)/$$f'"; \ - $(dist_docDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(docdir)/$$f"; \ + echo "$$d$$p"; \ + done | $(am__base_list) | \ + while read files; do \ + echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(shelfdir)'"; \ + $(INSTALL_DATA) $$files "$(DESTDIR)$(shelfdir)" || exit $$?; \ done -uninstall-dist_docDATA: +uninstall-dist_shelfDATA: @$(NORMAL_UNINSTALL) - @list='$(dist_doc_DATA)'; for p in $$list; do \ - f=$(am__strip_dir) \ - echo " rm -f '$(DESTDIR)$(docdir)/$$f'"; \ - rm -f "$(DESTDIR)$(docdir)/$$f"; \ - done -install-docDATA: $(doc_DATA) + @list='$(dist_shelf_DATA)'; test -n "$(shelfdir)" || list=; \ + files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \ + dir='$(DESTDIR)$(shelfdir)'; $(am__uninstall_files_from_dir) +install-shelfDATA: $(shelf_DATA) @$(NORMAL_INSTALL) - test -z "$(docdir)" || $(mkdir_p) "$(DESTDIR)$(docdir)" - @list='$(doc_DATA)'; for p in $$list; do \ + @list='$(shelf_DATA)'; test -n "$(shelfdir)" || list=; \ + if test -n "$$list"; then \ + echo " $(MKDIR_P) '$(DESTDIR)$(shelfdir)'"; \ + $(MKDIR_P) "$(DESTDIR)$(shelfdir)" || exit 1; \ + fi; \ + for p in $$list; do \ if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \ - f=$(am__strip_dir) \ - echo " $(docDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(docdir)/$$f'"; \ - $(docDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(docdir)/$$f"; \ + echo "$$d$$p"; \ + done | $(am__base_list) | \ + while read files; do \ + echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(shelfdir)'"; \ + $(INSTALL_DATA) $$files "$(DESTDIR)$(shelfdir)" || exit $$?; \ done -uninstall-docDATA: +uninstall-shelfDATA: @$(NORMAL_UNINSTALL) - @list='$(doc_DATA)'; for p in $$list; do \ - f=$(am__strip_dir) \ - echo " rm -f '$(DESTDIR)$(docdir)/$$f'"; \ - rm -f "$(DESTDIR)$(docdir)/$$f"; \ - done + @list='$(shelf_DATA)'; test -n "$(shelfdir)" || list=; \ + files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \ + dir='$(DESTDIR)$(shelfdir)'; $(am__uninstall_files_from_dir) tags: TAGS TAGS: ctags: CTAGS CTAGS: +cscope cscopelist: + distdir: $(DISTFILES) - @srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; \ - topsrcdirstrip=`echo "$(top_srcdir)" | sed 's|.|.|g'`; \ - list='$(DISTFILES)'; for file in $$list; do \ - case $$file in \ - $(srcdir)/*) file=`echo "$$file" | sed "s|^$$srcdirstrip/||"`;; \ - $(top_srcdir)/*) file=`echo "$$file" | sed "s|^$$topsrcdirstrip/|$(top_builddir)/|"`;; \ - esac; \ + @srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + list='$(DISTFILES)'; \ + dist_files=`for file in $$list; do echo $$file; done | \ + sed -e "s|^$$srcdirstrip/||;t" \ + -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \ + case $$dist_files in \ + */*) $(MKDIR_P) `echo "$$dist_files" | \ + sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \ + sort -u` ;; \ + esac; \ + for file in $$dist_files; do \ if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ - dir=`echo "$$file" | sed -e 's,/[^/]*$$,,'`; \ - if test "$$dir" != "$$file" && test "$$dir" != "."; then \ - dir="/$$dir"; \ - $(mkdir_p) "$(distdir)$$dir"; \ - else \ - dir=''; \ - fi; \ if test -d $$d/$$file; then \ + dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \ + if test -d "$(distdir)/$$file"; then \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ + fi; \ if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ - cp -pR $(srcdir)/$$file $(distdir)$$dir || exit 1; \ + cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ fi; \ - cp -pR $$d/$$file $(distdir)$$dir || exit 1; \ + cp -fpR $$d/$$file "$(distdir)$$dir" || exit 1; \ else \ - test -f $(distdir)/$$file \ - || cp -p $$d/$$file $(distdir)/$$file \ + test -f "$(distdir)/$$file" \ + || cp -p $$d/$$file "$(distdir)/$$file" \ || exit 1; \ fi; \ done @@ -328,8 +440,8 @@ check-am: all-am check: check-am all-am: Makefile $(DATA) installdirs: - for dir in "$(DESTDIR)$(docdir)" "$(DESTDIR)$(docdir)"; do \ - test -z "$$dir" || $(mkdir_p) "$$dir"; \ + for dir in "$(DESTDIR)$(shelfdir)" "$(DESTDIR)$(shelfdir)"; do \ + test -z "$$dir" || $(MKDIR_P) "$$dir"; \ done install: install-am install-exec: install-exec-am @@ -341,10 +453,15 @@ install-am: all-am installcheck: installcheck-am install-strip: - $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ - install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ - `test -z '$(STRIP)' || \ - echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install + if test -z '$(STRIP)'; then \ + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + install; \ + else \ + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'" install; \ + fi mostlyclean-generic: clean-generic: @@ -352,6 +469,7 @@ clean-generic: distclean-generic: -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) + -test . = "$(srcdir)" || test -z "$(CONFIG_CLEAN_VPATH_FILES)" || rm -f $(CONFIG_CLEAN_VPATH_FILES) maintainer-clean-generic: @echo "This command is intended for maintainers to use" @@ -370,18 +488,38 @@ dvi-am: html: html-am +html-am: + info: info-am info-am: -install-data-am: install-dist_docDATA install-docDATA +install-data-am: install-dist_shelfDATA install-shelfDATA + +install-dvi: install-dvi-am + +install-dvi-am: install-exec-am: +install-html: install-html-am + +install-html-am: + install-info: install-info-am +install-info-am: + install-man: +install-pdf: install-pdf-am + +install-pdf-am: + +install-ps: install-ps-am + +install-ps-am: + installcheck-am: maintainer-clean: maintainer-clean-am @@ -400,31 +538,37 @@ ps: ps-am ps-am: -uninstall-am: uninstall-dist_docDATA uninstall-docDATA \ - uninstall-info-am +uninstall-am: uninstall-dist_shelfDATA uninstall-shelfDATA + +.MAKE: install-am install-strip .PHONY: all all-am check check-am clean clean-generic distclean \ distclean-generic distdir dvi dvi-am html html-am info info-am \ install install-am install-data install-data-am \ - install-dist_docDATA install-docDATA install-exec \ - install-exec-am install-info install-info-am install-man \ - install-strip installcheck installcheck-am installdirs \ - maintainer-clean maintainer-clean-generic mostlyclean \ - mostlyclean-generic pdf pdf-am ps ps-am uninstall uninstall-am \ - uninstall-dist_docDATA uninstall-docDATA uninstall-info-am - - -@ENABLE_DOCS_TRUE@@HAVE_XMLTO_TRUE@.xml.txt: -@ENABLE_DOCS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) txt $< - -@ENABLE_DOCS_TRUE@@HAVE_XMLTO_TRUE@.xml.html: -@ENABLE_DOCS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) xhtml-nochunks $< - -@ENABLE_DOCS_TRUE@@HAVE_XMLTO_TRUE@.xml.pdf: -@ENABLE_DOCS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) --with-fop pdf $< + install-dist_shelfDATA install-dvi install-dvi-am install-exec \ + install-exec-am install-html install-html-am install-info \ + install-info-am install-man install-pdf install-pdf-am \ + install-ps install-ps-am install-shelfDATA install-strip \ + installcheck installcheck-am installdirs maintainer-clean \ + maintainer-clean-generic mostlyclean mostlyclean-generic pdf \ + pdf-am ps ps-am uninstall uninstall-am \ + uninstall-dist_shelfDATA uninstall-shelfDATA + +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@%.html: %.xml $(chapters) +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_HTML_FLAGS) xhtml-nochunks $< +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TEXT_TRUE@@HAVE_XMLTO_TRUE@%.txt: %.xml $(chapters) +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TEXT_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_HTML_FLAGS) txt $< +@ENABLE_DOCS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@%.pdf: %.xml $(chapters) +@ENABLE_DOCS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FO_FLAGS) --with-fop pdf $< +@ENABLE_DOCS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@%.ps: %.xml $(chapters) +@ENABLE_DOCS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FO_FLAGS) --with-fop ps $< +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@%.html.db: %.xml $(chapters) +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(AM_V_GEN)$(XSLTPROC) $(XSLT_HTML_FLAGS) $< +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@%.pdf.db: %.xml $(chapters) +@ENABLE_DOCS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(AM_V_GEN)$(XSLTPROC) $(XSLT_PDF_FLAGS) $< + +# Generate DocBook/XML output formats with or without stylesheets -@ENABLE_DOCS_TRUE@@HAVE_XMLTO_TRUE@.xml.ps: -@ENABLE_DOCS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) --with-fop ps $< # Tell versions [3.59,3.63) of GNU make to not export all variables. # Otherwise a system limit (for SysV at least) may be exceeded. .NOEXPORT: diff --git a/lib/libxtrans/doc/xtrans.xml b/lib/libxtrans/doc/xtrans.xml index 12dbe3c7f..59daa3fc0 100644 --- a/lib/libxtrans/doc/xtrans.xml +++ b/lib/libxtrans/doc/xtrans.xml @@ -24,7 +24,7 @@ </othercredit> </authorgroup> <releaseinfo>X Version 11, Release &fullrelvers;</releaseinfo> - <releaseinfo>Version 0.7</releaseinfo> + <releaseinfo>Version 1.2</releaseinfo> <copyright><year>1993</year><year>1994</year> <holder>NCR Corporation - Dayton, Ohio, USA</holder> </copyright> @@ -378,7 +378,8 @@ provide a more familiar interface that can be used to port existing code. <para> A macro is defined in Xtrans.h for TRANS(func) that creates a unique function name depending on where the code is compiled. For example, when built for -Xlib, TRANS(OpenCOTSClient) becomes <function>_X11TransOpenCOTSClient</function>. +Xlib, <function>TRANS(OpenCOTSClient)</function> becomes +<function>_X11TransOpenCOTSClient</function>. </para> <para> All failures are considered fatal, and the connection should be closed @@ -389,64 +390,85 @@ errno will be available for debugging purposes. <title>Core Interface API</title> <itemizedlist mark='bullet'> <listitem> - <para> -XtransConnInfo TRANS(OpenCOTSClient)(char *address) - </para> + <funcsynopsis id='TRANSOpenCOTSClient'> + <funcprototype> + <funcdef>XtransConnInfo <function>TRANS(OpenCOTSClient)</function></funcdef> + <paramdef>char *<parameter>address</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> This function creates a Connection-Oriented Transport that is suitable for use by a client. The parameter <parameter>address</parameter> -contains the full address of the server to which this endpoint will be connected. This -functions returns an opaque transport connection object on success, or -NULL on failure. +contains the full address of the server to which this endpoint will be +connected. This function returns an opaque transport connection object on +success, or <constant>NULL</constant> on failure. </para> </listitem> <listitem> - <para> -XtransConnInfo TRANS(OpenCOTSServer)(char *address) - </para> + <funcsynopsis id='TRANSOpenCOTSServer'> + <funcprototype> + <funcdef>XtransConnInfo <function>TRANS(OpenCOTSServer)</function></funcdef> + <paramdef>char *<parameter>address</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> This function creates a Connection-Oriented Transport that is suitable for use by a server. The parameter <parameter>address</parameter> contains the -full address to which this server will be bound. This functions returns an opaque -transport connection object on success, or NULL on failure. +full address to which this server will be bound. This function returns an +opaque transport connection object on success, or <constant>NULL</constant> +on failure. </para> </listitem> <listitem> - <para> -XtransConnInfo TRANS(OpenCLTSClient)(char *address) - </para> + <funcsynopsis id='TRANSOpenCLTSClient'> + <funcprototype> + <funcdef>XtransConnInfo <function>TRANS(OpenCLTSClient)</function></funcdef> + <paramdef>char *<parameter>address</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> This function creates a Connection-Less Transport that is suitable for use by a client. The parameter <parameter>address</parameter> contains the -full address of the server to which this endpoint will be connected. This functions -returns an opaque transport connection object on success, or NULL on failure. +full address of the server to which this endpoint will be connected. This +function returns an opaque transport connection object on success, or +<constant>NULL</constant> on failure. </para> </listitem> <listitem> - <para> -XtransConnInfo TRANS(OpenCLTSServer)(char *address) - </para> + <funcsynopsis id='TRANSOpenCLTSServer'> + <funcprototype> + <funcdef>XtransConnInfo <function>TRANS(OpenCLTSServer)</function></funcdef> + <paramdef>char *<parameter>address</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> This function creates a Connection-Less Transport that is suitable for use by a server. The parameter <parameter>address</parameter> contains the -full address to which this server will be bound. This functions returns an opaque -transport connection object on success, or NULL on failure. +full address to which this server will be bound. This function returns an +opaque transport connection object on success, or <constant>NULL</constant> +on failure. </para> </listitem> <listitem> - <para> -int TRANS(SetOption)(XtransConnInfo connection, int option, int arg) - </para> + <funcsynopsis id='TRANSSetOption'> + <funcprototype> + <funcdef>int <function>TRANS(SetOption)</function></funcdef> + <paramdef>XtransConnInfo <parameter>connection</parameter></paramdef> + <paramdef>int <parameter>option</parameter></paramdef> + <paramdef>int <parameter>arg</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> This function sets transport options, similar to the way <function>setsockopt()</function> and <function>ioctl()</function> work. The parameter <parameter>connection</parameter> is an endpoint -that was obtained from _XTransOpen*() functions. The parameter -<parameter>option</parameter> contains the option that will be set. The actual -values for option are defined in a later section. The parameter -<parameter>arg</parameter> can be used to pass in an additional value that may -be required by some options. This function return 0 on -success and -1 on failure. +that was obtained from <function>_XTransOpen*()</function> functions. +The parameter <parameter>option</parameter> contains the option that will +be set. The actual values for <parameter>option</parameter> are defined in a +<link linkend='Transport_Option_Definition'>later section</link>. +The parameter <parameter>arg</parameter> can be used to pass +in an additional value that may be required by some options. +This function returns 0 on success and -1 on failure. </para> <note><para> Based on current usage, the complimentary function @@ -454,16 +476,21 @@ Based on current usage, the complimentary function </para></note> </listitem> <listitem> - <para> -int TRANS(CreateListener)(XtransConnInfo connection, char *port, int flags) - </para> + <funcsynopsis id='TRANSCreateListener'> + <funcprototype> + <funcdef>int <function>TRANS(CreateListener)</function></funcdef> + <paramdef>XtransConnInfo <parameter>connection</parameter></paramdef> + <paramdef>char *<parameter>port</parameter></paramdef> + <paramdef>int <parameter>flags</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> This function sets up the server endpoint for listening. The parameter <parameter>connection</parameter> is an endpoint that was obtained from <function>TRANS(OpenCOTSServer)()</function> or <function>TRANS(OpenCLTSServer)()</function>. The parameter -<parameter>port</parameter> specifies the -port to which this endpoint should be bound for listening. If port is NULL, +<parameter>port</parameter> specifies the port to which this endpoint +should be bound for listening. If port is <constant>NULL</constant>, then the transport may attempt to allocate any available TSAP for this connection. If the transport cannot support this, then this function will return a failure. The <parameter>flags</parameter> parameter can be set @@ -474,9 +501,12 @@ function itself to fail. This function return 0 on success and -1 on failure. </para> </listitem> <listitem> - <para> -int TRANS(ResetListener)(XtransConnInfo connection) - </para> + <funcsynopsis id='TRANSResetListener'> + <funcprototype> + <funcdef>int <function>TRANS(ResetListener)</function></funcdef> + <paramdef>XtransConnInfo <parameter>connection</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> When a server is restarted, certain listen ports may need to be reset. For example, unix domain needs to check that the file used for @@ -491,44 +521,61 @@ This function will return one of the following values: </para> </listitem> <listitem> - <para> -XtransConnInfo TRANS(Accept)(XtransConnInfo connection) - </para> + <funcsynopsis id='TRANSAccept'> + <funcprototype> + <funcdef>XtransConnInfo <function>TRANS(Accept)</function></funcdef> + <paramdef>XtransConnInfo <parameter>connection</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> Once a connection indication is received, this function can be called to accept the connection. The parameter <parameter>connection</parameter> is an opened and bound endpoint that was obtained from <function>TRANS(OpenCOTSServer)()</function> and passed to <function>TRANS(CreateListener)()</function>. This function will return a -new opaque transport connection object upon success, NULL otherwise. +new opaque transport connection object upon success, +<constant>NULL</constant> otherwise. </para> </listitem> <listitem> - <para> -int TRANS(Connect)(XtransConnInfo connection, char *address) - </para> + <funcsynopsis id='TRANSConnect'> + <funcprototype> + <funcdef>int <function>TRANS(Connect)</function></funcdef> + <paramdef>XtransConnInfo <parameter>connection</parameter></paramdef> + <paramdef>char *<parameter>address</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> This function creates a connection to a server. The parameter <parameter>connection</parameter> is an endpoint that was obtained from <function>TRANS(OpenCOTSClient)()</function>. The parameter <parameter>address</parameter> specifies the TSAP to which this endpoint -should connect. If the -protocol is included in the address, it will be ignored. This function -return 0 on success and -1 on failure. +should connect. If the protocol is included in the address, it will be +ignored. This function returns 0 on success and -1 on failure. </para> </listitem> <listitem> + <funcsynopsis id='TRANSBytesReadable'> + <funcprototype> + <funcdef>int <function>TRANS(BytesReadable)</function></funcdef> + <paramdef>XtransConnInfo <parameter>connection</parameter></paramdef> + <paramdef>BytesReadable_t *<parameter>pend</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> -int TRANS(BytesReadable)(XtransConnInfo connection, BytesReadable_t *pend); - </para> - <para> -This function provides the same functionality as the BytesReadable macro. +This function provides the same functionality as the +<function>BytesReadable</function> macro. </para> </listitem> <listitem> - <para> -int TRANS(Read)(XtransConnInfo connection, char *buf, int size) - </para> + <funcsynopsis id='TRANSRead'> + <funcprototype> + <funcdef>int <function>TRANS(Read)</function></funcdef> + <paramdef>XtransConnInfo <parameter>connection</parameter></paramdef> + <paramdef>char *<parameter>buf</parameter></paramdef> + <paramdef>int <parameter>size</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> This function will return the number of bytes requested on a COTS connection, and will return the minimum of the number bytes requested or @@ -536,34 +583,52 @@ the size of the incoming packet on a CLTS connection. </para> </listitem> <listitem> - <para> -int TRANS(Write)(XtransConnInfo connection, char *buf, int size) - </para> + <funcsynopsis id='TRANSWrite'> + <funcprototype> + <funcdef>int <function>TRANS(Write)</function></funcdef> + <paramdef>XtransConnInfo <parameter>connection</parameter></paramdef> + <paramdef>char *<parameter>buf</parameter></paramdef> + <paramdef>int <parameter>size</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> This function will write the requested number of bytes on a COTS connection, and will send a packet of the requested size on a CLTS connection. </para> </listitem> <listitem> - <para> -int TRANS(Readv)(XtransConnInfo connection, struct iovec *buf, int size) - </para> + <funcsynopsis id='TRANSReadv'> + <funcprototype> + <funcdef>int <function>TRANS(Readv)</function></funcdef> + <paramdef>XtransConnInfo <parameter>connection</parameter></paramdef> + <paramdef>struct iovec *<parameter>buf</parameter></paramdef> + <paramdef>int <parameter>size</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> Similar to <function>TRANS(Read)()</function>. </para> </listitem> <listitem> - <para> - int TRANS(Writev)(XtransConnInfo connection, struct iovec *buf, int size) - </para> + <funcsynopsis id='TRANSWritev'> + <funcprototype> + <funcdef> int <function>TRANS(Writev)</function></funcdef> + <paramdef>XtransConnInfo <parameter>connection</parameter></paramdef> + <paramdef>struct iovec *<parameter>buf</parameter></paramdef> + <paramdef>int <parameter>size</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> Similar to <function>TRANS(Write)()</function>. </para> </listitem> <listitem> - <para> -int TRANS(Disconnect)(XtransConnInfo connection) - </para> + <funcsynopsis id='TRANSDisconnect'> + <funcprototype> + <funcdef>int <function>TRANS(Disconnect)</function></funcdef> + <paramdef>XtransConnInfo <parameter>connection</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> This function is used when an orderly disconnect is desired. This function breaks the connection on the transport. It is similar to the socket function @@ -571,9 +636,12 @@ breaks the connection on the transport. It is similar to the socket function </para> </listitem> <listitem> - <para> -int TRANS(Close)(XtransConnInfo connection) - </para> + <funcsynopsis id='TRANSClose'> + <funcprototype> + <funcdef>int <function>TRANS(Close)</function></funcdef> + <paramdef>XtransConnInfo <parameter>connection</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> This function closes the transport, unbinds it, and frees all resources that was associated with the transport. If a <function>TRANS(Disconnect)</function> @@ -581,58 +649,75 @@ call was not made on the connection, a disorderly disconnect may occur. </para> </listitem> <listitem> - <para> -int TRANS(IsLocal)(XtransConnInfo connection) - </para> + <funcsynopsis id='TRANSIsLocal'> + <funcprototype> + <funcdef>int <function>TRANS(IsLocal)</function></funcdef> + <paramdef>XtransConnInfo <parameter>connection</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> Returns TRUE if it is a local transport. </para> </listitem> <listitem> - <para> -int TRANS(GetMyAddr)(XtransConnInfo connection, int *familyp, int *addrlenp, -Xtransaddr **addrp) - </para> - <para> -This function is similar to -<function>getsockname()</function>. + <funcsynopsis id='TRANSGetMyAddr'> + <funcprototype> + <funcdef>int <function>TRANS(GetMyAddr)</function></funcdef> + <paramdef>XtransConnInfo <parameter>connection</parameter></paramdef> + <paramdef>int *<parameter>familyp</parameter></paramdef> + <paramdef>int *<parameter>addrlenp</parameter></paramdef> + <paramdef>Xtransaddr **<parameter>addrp</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> +This function is similar to <function>getsockname()</function>. This function will allocate space for the address, so it must be freed by the caller. Not all transports will have a valid address until a connection is established. This function should not be used until the connection is -established with -<function>Connect()</function> or +established with <function>Connect()</function> or <function>Accept()</function>. </para> </listitem> <listitem> - <para> -int TRANS(GetPeerAddr)(XtransConnInfo connection, int *familyp, int *addrlenp, -Xtransaddr **addrp) - </para> - <para> -This function is similar to -<function>getpeername()</function>. + <funcsynopsis id='TRANSGetPeerAddr'> + <funcprototype> + <funcdef>int <function>TRANS(GetPeerAddr)</function></funcdef> + <paramdef>XtransConnInfo <parameter>connection</parameter></paramdef> + <paramdef>int *<parameter>familyp</parameter></paramdef> + <paramdef>int *<parameter>addrlenp</parameter></paramdef> + <paramdef>Xtransaddr **<parameter>addrp</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> +This function is similar to <function>getpeername()</function>. This function will allocate space for the address, so it must be freed by the caller. Not all transports will have a valid address until a connection is established. This function should not be used until the connection is -established with -<function>Connect()</function> or +established with <function>Connect()</function> or <function>Accept()</function>. </para> </listitem> <listitem> - <para> -int TRANS(GetConnectionNumber)(XtransConnInfo connection) - </para> + <funcsynopsis id='TRANSGetConnectionNumber'> + <funcprototype> + <funcdef>int <function>TRANS(GetConnectionNumber)</function></funcdef> + <paramdef>XtransConnInfo <parameter>connection</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> Returns the file descriptor associated with this transport. </para> </listitem> <listitem> - <para> -int TRANS(MakeAllCOTSServerListeners)(char *port, int *partial_ret, -int *count_ret, XtransConnInfo **connections_ret) - </para> + <funcsynopsis id='TRANSMakeAllCOTSServerListeners'> + <funcprototype> + <funcdef>int <function>TRANS(MakeAllCOTSServerListeners)</function></funcdef> + <paramdef>char *<parameter>port</parameter></paramdef> + <paramdef>int *<parameter>partial_ret</parameter></paramdef> + <paramdef>int *<parameter>count_ret</parameter></paramdef> + <paramdef>XtransConnInfo **<parameter>connections_ret</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> This function should be used by most servers. It will try to establish a COTS server endpoint for each transport listed in the transport table. @@ -643,10 +728,15 @@ is the list of transports. </para> </listitem> <listitem> - <para> -int TRANS(MakeAllCLTSServerListeners)( char *port, int *partial_ret, -int *count_ret, XtransConnInfo **connections_ret) - </para> + <funcsynopsis id='TRANSMakeAllCLTSServerListeners'> + <funcprototype> + <funcdef>int <function>TRANS(MakeAllCLTSServerListeners)</function></funcdef> + <paramdef>char *<parameter>port</parameter></paramdef> + <paramdef>int *<parameter>partial_ret</parameter></paramdef> + <paramdef>int *<parameter>count_ret</parameter></paramdef> + <paramdef>XtransConnInfo **<parameter>connections_ret</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> This function should be used by most servers. It will try to establish a CLTS server endpoint for each transport listed in the transport table. @@ -668,13 +758,19 @@ convenience. </para> <itemizedlist mark='bullet'> <listitem> - <para> -int TRANS(ConvertAddress)(int *familyp, int *addrlenp, Xtransaddr *addrp) - </para> + <funcsynopsis id='TRANSConvertAddress'> + <funcprototype> + <funcdef>int <function>TRANS(ConvertAddress)</function></funcdef> + <paramdef>int *<parameter>familyp</parameter></paramdef> + <paramdef>int *<parameter>addrlenp</parameter></paramdef> + <paramdef>Xtransaddr *<parameter>addrp</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> This function converts a sockaddr based address to an X authorization based -address (ie AF_INET, AF_UNIX to the X protocol definition (ie FamilyInternet, -FamilyLocal)). +address (ie <symbol>AF_INET</symbol>, <symbol>AF_UNIX</symbol> to the X +protocol definition (ie <symbol>FamilyInternet</symbol>, +<symbol>FamilyLocal</symbol>)). </para> </listitem> </itemizedlist> @@ -685,8 +781,8 @@ FamilyLocal)). <title>Transport Option Definition</title> <para> The following options are defined for the -<function>TRANS(SetOption)()</function> - function. If an OS or transport does not support any of these options, +<link linkend='TRANSSetOption'><function>TRANS(SetOption)()</function></link> +function. If an OS or transport does not support any of these options, then it will silently ignore the option. </para> @@ -726,18 +822,22 @@ the <code>#ifdef SUNSYSV</code> should be handled inside these functions. <itemizedlist mark='bullet'> <listitem> - <para> -XtransConnInfo *OpenCOTSClient ( -struct _Xtransport *thistrans, char *protocol, char *host, char *port) - </para> + <funcsynopsis id='OpenCOTSClient'> + <funcprototype> + <funcdef>XtransConnInfo *<function>OpenCOTSClient</function></funcdef> + <paramdef>struct _Xtransport *<parameter>thistrans</parameter></paramdef> + <paramdef>char *<parameter>protocol</parameter></paramdef> + <paramdef>char *<parameter>host</parameter></paramdef> + <paramdef>char *<parameter>port</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> This function creates a Connection-Oriented Transport. The parameter -<parameter>thistrans</parameter> -points to an Xtransport entry in the transport table. The parameters -<parameter>protocol</parameter>, -<parameter>host</parameter>, and -<parameter>port</parameter>, point to strings containing the corresponding -parts of the address that was passed into <function>TRANS(OpenCOTSClient)()</function>. +<parameter>thistrans</parameter> points to an Xtransport entry in the +transport table. The parameters <parameter>protocol</parameter>, +<parameter>host</parameter>, and <parameter>port</parameter>, point to +strings containing the corresponding parts of the address that was passed into +<link linkend='TRANSOpenCOTSClient'><function>TRANS(OpenCOTSClient)()</function></link>. This function must allocate and initialize the contents of the XtransConnInfo structure that is returned by this function. This function will open the transport, and bind it into the transport namespace if applicable. The local @@ -746,39 +846,44 @@ this function. </para> </listitem> <listitem> - <para> -XtransConnInfo *OpenCOTSServer ( -struct _Xtransport *thistrans, char *protocol, char *host, char *port) - </para> + <funcsynopsis id='OpenCOTSServer'> + <funcprototype> + <funcdef>XtransConnInfo *<function>OpenCOTSServer</function></funcdef> + <paramdef>struct _Xtransport *<parameter>thistrans</parameter></paramdef> + <paramdef>char *<parameter>protocol</parameter></paramdef> + <paramdef>char *<parameter>host</parameter></paramdef> + <paramdef>char *<parameter>port</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> This function creates a Connection-Oriented Transport. The parameter -<parameter>thistrans</parameter> -points to an Xtransport entry in the transport table. The -parameters -<parameter>protocol</parameter>, -<parameter>host</parameter>, and -<parameter>port</parameter> point to strings containing the -corresponding parts of the address that was passed into -<function>TRANS(OpenCOTSClient)()</function>. +<parameter>thistrans</parameter> points to an Xtransport entry in the +transport table. The parameters <parameter>protocol</parameter>, +<parameter>host</parameter>, and <parameter>port</parameter> point to +strings containing the corresponding parts of the address that was passed into +<link linkend='TRANSOpenCOTSServer'><function>TRANS(OpenCOTSServer)()</function></link>. This function must allocate and initialize the contents of the XtransConnInfo structure that is returned by this function. This function will open the transport. </para> </listitem> <listitem> - <para> -XtransConnInfo *OpenCLTSClient ( -struct _Xtransport *thistrans, char *protocol, char *host, char *port) - </para> + <funcsynopsis id='OpenCLTSClient'> + <funcprototype> + <funcdef>XtransConnInfo *<function>OpenCLTSClient</function></funcdef> + <paramdef>struct _Xtransport *<parameter>thistrans</parameter></paramdef> + <paramdef>char *<parameter>protocol</parameter></paramdef> + <paramdef>char *<parameter>host</parameter></paramdef> + <paramdef>char *<parameter>port</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> This function creates a Connection-Less Transport. The parameter -<parameter>thistrans</parameter> -points to an Xtransport entry in the transport table. The parameters -<parameter>protocol</parameter>, -<parameter>host</parameter>, and -<parameter>port</parameter> point to strings containing the -corresponding parts of the address that was passed into -<function>TRANS(OpenCOTSClient)()</function>. +<parameter>thistrans</parameter> points to an Xtransport entry in the +transport table. The parameters <parameter>protocol</parameter>, +<parameter>host</parameter>, and <parameter>port</parameter> point to strings +containing the corresponding parts of the address that was passed into +<link linkend='TRANSOpenCLTSClient'><function>TRANS(OpenCLTSClient)()</function></link>. This function must allocate and initialize the contents of the XtransConnInfo structure that is returned by this function. This function will open the transport, and bind it into the transport namespace if applicable. The @@ -787,28 +892,36 @@ in by this function. </para> </listitem> <listitem> - <para> -XtransConnInfo *OpenCLTSServer ( -struct _Xtransport *thistrans, char *protocol, char *host, char *port) - </para> + <funcsynopsis id='OpenCLTSServer'> + <funcprototype> + <funcdef>XtransConnInfo *<function>OpenCLTSServer</function></funcdef> + <paramdef>struct _Xtransport *<parameter>thistrans</parameter></paramdef> + <paramdef>char *<parameter>protocol</parameter></paramdef> + <paramdef>char *<parameter>host</parameter></paramdef> + <paramdef>char *<parameter>port</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> This function creates a Connection-Less Transport. The parameter -<parameter>thistrans</parameter> -points to an Xtransport entry in the transport table. The parameters -<parameter>protocol</parameter>, -<parameter>host</parameter>, and -<parameter>port</parameter> point to strings containing the -corresponding parts of the address that was passed into -<function>TRANS(OpenCOTSClient)()</function>. +<parameter>thistrans</parameter> points to an Xtransport entry in the +transport table. The parameters <parameter>protocol</parameter>, +<parameter>host</parameter>, and <parameter>port</parameter> point to strings +containing the corresponding parts of the address that was passed into +<link linkend='TRANSOpenCLTSServer'><function>TRANS(OpenCLTSServer)()</function></link>. This function must allocate and initialize the contents of the XtransConnInfo structure that is returned by this function. This function will open the transport. </para> </listitem> <listitem> - <para> -int SetOption (struct _Xtransport *thistrans, int option, int arg) - </para> + <funcsynopsis id='SetOption'> + <funcprototype> + <funcdef>int <function>SetOption</function></funcdef> + <paramdef>struct _Xtransport *<parameter>thistrans</parameter></paramdef> + <paramdef>int <parameter>option</parameter></paramdef> + <paramdef>int <parameter>arg</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> This function provides a transport dependent way of implementing the options defined by the X Transport Interface. In the current prototype, @@ -818,9 +931,14 @@ different transport type is added, or a transport dependent option is defined. </para> </listitem> <listitem> - <para> -int CreateListener (struct _Xtransport *thistrans, char *port, int flags ) - </para> + <funcsynopsis id='CreateListener'> + <funcprototype> + <funcdef>int <function>CreateListener</function></funcdef> + <paramdef>struct _Xtransport *<parameter>thistrans</parameter></paramdef> + <paramdef>char <parameter>*port</parameter></paramdef> + <paramdef>int <parameter>flags</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> This function takes a transport endpoint opened for a server, and sets it up to listen for incoming connection requests. The parameter @@ -838,17 +956,23 @@ listen for incoming connection requests. </para> </listitem> <listitem> - <para> -int ResetListener (struct _Xtransport *thistrans) - </para> + <funcsynopsis id='ResetListener'> + <funcprototype> + <funcdef>int <function>ResetListener</function></funcdef> + <paramdef>struct _Xtransport *<parameter>thistrans</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> This function resets the transport for listening. </para> </listitem> <listitem> - <para> - XtransConnInfo Accept(struct _Xtransport *thistrans) - </para> + <funcsynopsis id='Accept'> + <funcprototype> + <funcdef> XtransConnInfo <function>Accept</function></funcdef> + <paramdef>struct _Xtransport *<parameter>thistrans</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> This function creates a new transport endpoint as a result of an incoming connection request. The parameter @@ -859,13 +983,17 @@ structure describing the new endpoint is returned from this function </para> </listitem> <listitem> - <para> -int Connect(struct _Xtransport *thistrans, char *host, char *port ) - </para> + <funcsynopsis id='Connect'> + <funcprototype> + <funcdef>int <function>Connect</function></funcdef> + <paramdef>struct _Xtransport *<parameter>thistrans</parameter></paramdef> + <paramdef>char *<parameter>host</parameter></paramdef> + <paramdef>char *<parameter>port</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> This function establishes a connection to a server. The parameters -<parameter>host</parameter> and -<parameter>port</parameter> +<parameter>host</parameter> and <parameter>port</parameter> describe the server to which the connection should be established. The connection will be established so that <function>Read()</function> and @@ -873,52 +1001,80 @@ established. The connection will be established so that </para> </listitem> <listitem> - <para> -int BytesReadable(struct _Xtransport *thistrans, BytesReadable_t *pend ) - </para> - <para> -This function replaces the -<function>BytesReadable()</function> -macro. This allows each transport to have it’s own mechanism for determining + <funcsynopsis id='BytesReadable'> + <funcprototype> + <funcdef>int <function>BytesReadable</function></funcdef> + <paramdef>struct _Xtransport *<parameter>thistrans</parameter></paramdef> + <paramdef>BytesReadable_t *<parameter>pend</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> +This function replaces the <function>BytesReadable()</function> +macro. This allows each transport to have its own mechanism for determining how much data is ready to be read. </para> </listitem> <listitem> - <para> -int Read(struct _Xtransport *thistrans, char *buf, int size ) - </para> - <para> -This function reads size bytes into buf from the connection. + <funcsynopsis id='Read'> + <funcprototype> + <funcdef>int <function>Read</function></funcdef> + <paramdef>struct _Xtransport *<parameter>thistrans</parameter></paramdef> + <paramdef>char *<parameter>buf</parameter></paramdef> + <paramdef>int <parameter>size</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> +This function reads <parameter>size</parameter> bytes into +<parameter>buf</parameter> from the connection. </para> </listitem> <listitem> - <para> -int Write(struct _Xtransport *thistrans, char *buf, int size ) - </para> - <para> -This function writes size bytes from buf to the connection. + <funcsynopsis id='Write'> + <funcprototype> + <funcdef>int <function>Write</function></funcdef> + <paramdef>struct _Xtransport *<parameter>thistrans</parameter></paramdef> + <paramdef>char *<parameter>buf</parameter></paramdef> + <paramdef>int <parameter>size</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> +This function writes <parameter>size</parameter> bytes from +<parameter>buf</parameter> to the connection. </para> </listitem> <listitem> - <para> -int Readv(struct _Xtransport *thistrans, struct iovec *buf, int size ) - </para> + <funcsynopsis id='Readv'> + <funcprototype> + <funcdef>int <function>Readv</function></funcdef> + <paramdef>struct _Xtransport *<parameter>thistrans</parameter></paramdef> + <paramdef>struct iovec *<parameter>buf</parameter></paramdef> + <paramdef>int <parameter>size</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> This function performs a <function>readv()</function> on the connection. </para> </listitem> <listitem> - <para> -int Writev(struct _Xtransport *thistrans, struct iovec *buf, int size ) - </para> + <funcsynopsis id='Writev'> + <funcprototype> + <funcdef>int <function>Writev</function></funcdef> + <paramdef>struct _Xtransport *<parameter>thistrans</parameter></paramdef> + <paramdef>struct iovec *<parameter>buf</parameter></paramdef> + <paramdef>int <parameter>size</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> This function performs a <function>writev()</function> on the connection. </para> </listitem> <listitem> - <para> -int Disconnect(struct _Xtransport *thistrans) - </para> + <funcsynopsis id='Disconnect'> + <funcprototype> + <funcdef>int <function>Disconnect</function></funcdef> + <paramdef>struct _Xtransport *<parameter>thistrans</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> This function initiates an orderly shutdown of a connection. If a transport does not distinguish between orderly and disorderly @@ -926,9 +1082,12 @@ disconnects, then a call to this function will have no affect. </para> </listitem> <listitem> - <para> -int Close(struct _Xtransport *thistrans) - </para> + <funcsynopsis id='Close'> + <funcprototype> + <funcdef>int <function>Close</function></funcdef> + <paramdef>struct _Xtransport *<parameter>thistrans</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> This function will break the connection, and close the endpoint. </para> @@ -1100,11 +1259,7 @@ All functions names in the source are of the format <function>TRANS()</function> macro is defined as <programlisting language="C"> -#if (__STDC__ && !defined(UNIXCPP)) || defined(ANSICPP) #define TRANS(func) _PROTOCOLTrans##func -#else -#define TRANS(func) _PROTOCOLTrans/**/func -#endif </programlisting> </para> |