mirror of
https://gitlab.gnome.org/GNOME/libxslt
synced 2025-07-31 02:43:06 +03:00
Moved the man pages to section 3 applied patch from Peter Breitenlohner
* libxslt.spec.in libexslt/Makefile.am libexslt/libexslt.3 libxslt/Makefile.am libxslt/libxslt.3: Moved the man pages to section 3 * libexslt/sets.c: applied patch from Peter Breitenlohner * doc/*: rebuilt the docs * tests/docbook/result//* tests/xmlspec/*.html: changes in generattion of " as " in element content. Daniel
This commit is contained in:
Daniel Veillard
10
ChangeLog
10
ChangeLog
@ -1,3 +1,13 @@
|
|||||||
|
Fri Jun 13 16:53:33 CEST 2003 Daniel Veillard <daniel@veillard.com>
|
||||||
|
|
||||||
|
* libxslt.spec.in libexslt/Makefile.am libexslt/libexslt.3
|
||||||
|
libxslt/Makefile.am libxslt/libxslt.3: Moved the man pages
|
||||||
|
to section 3
|
||||||
|
* libexslt/sets.c: applied patch from Peter Breitenlohner
|
||||||
|
* doc/*: rebuilt the docs
|
||||||
|
* tests/docbook/result//* tests/xmlspec/*.html: changes in
|
||||||
|
generattion of " as " in element content.
|
||||||
|
|
||||||
Sun Jun 08 22:57:13 CEST 2003 Igor Zlatkovic <igor@zlatkovic.com>
|
Sun Jun 08 22:57:13 CEST 2003 Igor Zlatkovic <igor@zlatkovic.com>
|
||||||
|
|
||||||
* libxslt/transform.c: changed xsltChoose to ignore whitespace
|
* libxslt/transform.c: changed xsltChoose to ignore whitespace
|
||||||
|
|||||||
@ -1,4 +1,3 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
||||||
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Gnome XSLT Library Reference Manual</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><meta name="description" content="This manual documents the interfaces of the libxslt
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Gnome XSLT Library Reference Manual</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><meta name="description" content="This manual documents the interfaces of the libxslt
|
||||||
library and has some short notes to help get you up to speed
|
library and has some short notes to help get you up to speed
|
||||||
with using the library."><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
with using the library."><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
||||||
|
|||||||
@ -226,6 +226,10 @@
|
|||||||
<ANCHOR id="xsltParseTemplateContent" href="libxslt/libxslt-xsltInternals.html#xsltParseTemplateContent">
|
<ANCHOR id="xsltParseTemplateContent" href="libxslt/libxslt-xsltInternals.html#xsltParseTemplateContent">
|
||||||
<ANCHOR id="xsltAllocateExtra" href="libxslt/libxslt-xsltInternals.html#xsltAllocateExtra">
|
<ANCHOR id="xsltAllocateExtra" href="libxslt/libxslt-xsltInternals.html#xsltAllocateExtra">
|
||||||
<ANCHOR id="xsltAllocateExtraCtxt" href="libxslt/libxslt-xsltInternals.html#xsltAllocateExtraCtxt">
|
<ANCHOR id="xsltAllocateExtraCtxt" href="libxslt/libxslt-xsltInternals.html#xsltAllocateExtraCtxt">
|
||||||
|
<ANCHOR id="xsltCreateRVT" href="libxslt/libxslt-xsltInternals.html#xsltCreateRVT">
|
||||||
|
<ANCHOR id="xsltRegisterTmpRVT" href="libxslt/libxslt-xsltInternals.html#xsltRegisterTmpRVT">
|
||||||
|
<ANCHOR id="xsltRegisterPersistRVT" href="libxslt/libxslt-xsltInternals.html#xsltRegisterPersistRVT">
|
||||||
|
<ANCHOR id="xsltFreeRVTs" href="libxslt/libxslt-xsltInternals.html#xsltFreeRVTs">
|
||||||
<ANCHOR id="xsltNumberData" href="libxslt/libxslt-numbersInternals.html#xsltNumberData">
|
<ANCHOR id="xsltNumberData" href="libxslt/libxslt-numbersInternals.html#xsltNumberData">
|
||||||
<ANCHOR id="xsltNumberDataPtr" href="libxslt/libxslt-numbersInternals.html#xsltNumberDataPtr">
|
<ANCHOR id="xsltNumberDataPtr" href="libxslt/libxslt-numbersInternals.html#xsltNumberDataPtr">
|
||||||
<ANCHOR id="xsltFormatNumberInfo" href="libxslt/libxslt-numbersInternals.html#xsltFormatNumberInfo">
|
<ANCHOR id="xsltFormatNumberInfo" href="libxslt/libxslt-numbersInternals.html#xsltFormatNumberInfo">
|
||||||
|
|||||||
@ -1,4 +1,3 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
||||||
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>attributes</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>attributes</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
||||||
.synopsis, .classsynopsis {
|
.synopsis, .classsynopsis {
|
||||||
background: #eeeeee;
|
background: #eeeeee;
|
||||||
|
|||||||
@ -1,4 +1,3 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
||||||
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>extensions</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>extensions</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
||||||
.synopsis, .classsynopsis {
|
.synopsis, .classsynopsis {
|
||||||
background: #eeeeee;
|
background: #eeeeee;
|
||||||
|
|||||||
@ -1,4 +1,3 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
||||||
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>functions</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>functions</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
||||||
.synopsis, .classsynopsis {
|
.synopsis, .classsynopsis {
|
||||||
background: #eeeeee;
|
background: #eeeeee;
|
||||||
|
|||||||
@ -1,4 +1,3 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
||||||
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>imports</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>imports</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
||||||
.synopsis, .classsynopsis {
|
.synopsis, .classsynopsis {
|
||||||
background: #eeeeee;
|
background: #eeeeee;
|
||||||
|
|||||||
@ -1,4 +1,3 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
||||||
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>keys</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>keys</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
||||||
.synopsis, .classsynopsis {
|
.synopsis, .classsynopsis {
|
||||||
background: #eeeeee;
|
background: #eeeeee;
|
||||||
|
|||||||
@ -1,4 +1,3 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
||||||
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Libxslt Library Reference</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Libxslt Library Reference</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
||||||
.synopsis, .classsynopsis {
|
.synopsis, .classsynopsis {
|
||||||
background: #eeeeee;
|
background: #eeeeee;
|
||||||
|
|||||||
@ -1,4 +1,3 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
||||||
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>namespaces</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>namespaces</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
||||||
.synopsis, .classsynopsis {
|
.synopsis, .classsynopsis {
|
||||||
background: #eeeeee;
|
background: #eeeeee;
|
||||||
|
|||||||
@ -1,4 +1,3 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
||||||
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Libxslt Programming Notes</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Libxslt Programming Notes</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
||||||
.synopsis, .classsynopsis {
|
.synopsis, .classsynopsis {
|
||||||
background: #eeeeee;
|
background: #eeeeee;
|
||||||
|
|||||||
@ -1,4 +1,3 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
||||||
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>numbersInternals</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>numbersInternals</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
||||||
.synopsis, .classsynopsis {
|
.synopsis, .classsynopsis {
|
||||||
background: #eeeeee;
|
background: #eeeeee;
|
||||||
|
|||||||
@ -1,395 +0,0 @@
|
|||||||
<HTML
|
|
||||||
><HEAD
|
|
||||||
><TITLE
|
|
||||||
>numbersInternals</TITLE
|
|
||||||
><META
|
|
||||||
NAME="GENERATOR"
|
|
||||||
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
|
|
||||||
"><LINK
|
|
||||||
REL="HOME"
|
|
||||||
TITLE="Gnome XSLT Library Reference Manual"
|
|
||||||
HREF="book1.html"><LINK
|
|
||||||
REL="UP"
|
|
||||||
TITLE="Libxslt Library Reference"
|
|
||||||
HREF="libxslt-lib.html"><LINK
|
|
||||||
REL="PREVIOUS"
|
|
||||||
TITLE="xsltInternals"
|
|
||||||
HREF="libxslt-xsltinternals.html"></HEAD
|
|
||||||
><BODY
|
|
||||||
CLASS="REFENTRY"
|
|
||||||
BGCOLOR="#FFFFFF"
|
|
||||||
TEXT="#000000"
|
|
||||||
LINK="#0000FF"
|
|
||||||
VLINK="#840084"
|
|
||||||
ALINK="#0000FF"
|
|
||||||
><DIV
|
|
||||||
CLASS="NAVHEADER"
|
|
||||||
><TABLE
|
|
||||||
WIDTH="100%"
|
|
||||||
BORDER="0"
|
|
||||||
BGCOLOR="#000000"
|
|
||||||
CELLPADDING="1"
|
|
||||||
CELLSPACING="0"
|
|
||||||
><TR
|
|
||||||
><TH
|
|
||||||
COLSPAN="4"
|
|
||||||
ALIGN="center"
|
|
||||||
><FONT
|
|
||||||
COLOR="#FFFFFF"
|
|
||||||
SIZE="5"
|
|
||||||
>Gnome XSLT Library Reference Manual</FONT
|
|
||||||
></TH
|
|
||||||
></TR
|
|
||||||
><TR
|
|
||||||
><TD
|
|
||||||
WIDTH="25%"
|
|
||||||
BGCOLOR="#C00000"
|
|
||||||
ALIGN="left"
|
|
||||||
><A
|
|
||||||
HREF="libxslt-xsltinternals.html"
|
|
||||||
><FONT
|
|
||||||
COLOR="#FFFFFF"
|
|
||||||
SIZE="3"
|
|
||||||
><B
|
|
||||||
><<< Previous Page</B
|
|
||||||
></FONT
|
|
||||||
></A
|
|
||||||
></TD
|
|
||||||
><TD
|
|
||||||
WIDTH="25%"
|
|
||||||
BGCOLOR="#0000C0"
|
|
||||||
ALIGN="center"
|
|
||||||
><FONT
|
|
||||||
COLOR="#FFFFFF"
|
|
||||||
SIZE="3"
|
|
||||||
><B
|
|
||||||
><A
|
|
||||||
HREF="book1.html"
|
|
||||||
><FONT
|
|
||||||
COLOR="#FFFFFF"
|
|
||||||
SIZE="3"
|
|
||||||
><B
|
|
||||||
>Home</B
|
|
||||||
></FONT
|
|
||||||
></A
|
|
||||||
></B
|
|
||||||
></FONT
|
|
||||||
></TD
|
|
||||||
><TD
|
|
||||||
WIDTH="25%"
|
|
||||||
BGCOLOR="#00C000"
|
|
||||||
ALIGN="center"
|
|
||||||
><FONT
|
|
||||||
COLOR="#FFFFFF"
|
|
||||||
SIZE="3"
|
|
||||||
><B
|
|
||||||
><A
|
|
||||||
HREF="libxslt-lib.html"
|
|
||||||
><FONT
|
|
||||||
COLOR="#FFFFFF"
|
|
||||||
SIZE="3"
|
|
||||||
><B
|
|
||||||
>Up</B
|
|
||||||
></FONT
|
|
||||||
></A
|
|
||||||
></B
|
|
||||||
></FONT
|
|
||||||
></TD
|
|
||||||
><TD
|
|
||||||
WIDTH="25%"
|
|
||||||
BGCOLOR="#C00000"
|
|
||||||
ALIGN="right"
|
|
||||||
> </TD
|
|
||||||
></TR
|
|
||||||
></TABLE
|
|
||||||
></DIV
|
|
||||||
><H1
|
|
||||||
><A
|
|
||||||
NAME="LIBXSLT-NUMBERSINTERNALS"
|
|
||||||
></A
|
|
||||||
>numbersInternals</H1
|
|
||||||
><DIV
|
|
||||||
CLASS="REFNAMEDIV"
|
|
||||||
><A
|
|
||||||
NAME="AEN6039"
|
|
||||||
></A
|
|
||||||
><H2
|
|
||||||
>Name</H2
|
|
||||||
>numbersInternals -- </DIV
|
|
||||||
><DIV
|
|
||||||
CLASS="REFSYNOPSISDIV"
|
|
||||||
><A
|
|
||||||
NAME="AEN6042"
|
|
||||||
></A
|
|
||||||
><H2
|
|
||||||
>Synopsis</H2
|
|
||||||
><TABLE
|
|
||||||
BORDER="0"
|
|
||||||
BGCOLOR="#D6E8FF"
|
|
||||||
WIDTH="100%"
|
|
||||||
CELLPADDING="6"
|
|
||||||
><TR
|
|
||||||
><TD
|
|
||||||
><PRE
|
|
||||||
CLASS="SYNOPSIS"
|
|
||||||
>
|
|
||||||
|
|
||||||
struct <A
|
|
||||||
HREF="libxslt-numbersinternals.html#XSLTNUMBERDATA"
|
|
||||||
>xsltNumberData</A
|
|
||||||
>;
|
|
||||||
typedef <A
|
|
||||||
HREF="libxslt-numbersinternals.html#XSLTNUMBERDATAPTR"
|
|
||||||
>xsltNumberDataPtr</A
|
|
||||||
>;
|
|
||||||
struct <A
|
|
||||||
HREF="libxslt-numbersinternals.html#XSLTFORMATNUMBERINFO"
|
|
||||||
>xsltFormatNumberInfo</A
|
|
||||||
>;
|
|
||||||
typedef <A
|
|
||||||
HREF="libxslt-numbersinternals.html#XSLTFORMATNUMBERINFOPTR"
|
|
||||||
>xsltFormatNumberInfoPtr</A
|
|
||||||
>;</PRE
|
|
||||||
></TD
|
|
||||||
></TR
|
|
||||||
></TABLE
|
|
||||||
></DIV
|
|
||||||
><DIV
|
|
||||||
CLASS="REFSECT1"
|
|
||||||
><A
|
|
||||||
NAME="AEN6049"
|
|
||||||
></A
|
|
||||||
><H2
|
|
||||||
>Description</H2
|
|
||||||
><P
|
|
||||||
></P
|
|
||||||
></DIV
|
|
||||||
><DIV
|
|
||||||
CLASS="REFSECT1"
|
|
||||||
><A
|
|
||||||
NAME="AEN6052"
|
|
||||||
></A
|
|
||||||
><H2
|
|
||||||
>Details</H2
|
|
||||||
><DIV
|
|
||||||
CLASS="REFSECT2"
|
|
||||||
><A
|
|
||||||
NAME="AEN6054"
|
|
||||||
></A
|
|
||||||
><H3
|
|
||||||
><A
|
|
||||||
NAME="XSLTNUMBERDATA"
|
|
||||||
></A
|
|
||||||
>struct xsltNumberData</H3
|
|
||||||
><TABLE
|
|
||||||
BORDER="0"
|
|
||||||
BGCOLOR="#D6E8FF"
|
|
||||||
WIDTH="100%"
|
|
||||||
CELLPADDING="6"
|
|
||||||
><TR
|
|
||||||
><TD
|
|
||||||
><PRE
|
|
||||||
CLASS="PROGRAMLISTING"
|
|
||||||
>struct xsltNumberData {
|
|
||||||
xmlChar *level;
|
|
||||||
xmlChar *count;
|
|
||||||
xmlChar *from;
|
|
||||||
xmlChar *value;
|
|
||||||
xmlChar *format;
|
|
||||||
int has_format;
|
|
||||||
int digitsPerGroup;
|
|
||||||
int groupingCharacter;
|
|
||||||
int groupingCharacterLen;
|
|
||||||
xmlDocPtr doc;
|
|
||||||
xmlNodePtr node;
|
|
||||||
};</PRE
|
|
||||||
></TD
|
|
||||||
></TR
|
|
||||||
></TABLE
|
|
||||||
><P
|
|
||||||
>This data structure is just a wrapper to pass xsl:number data in.</P
|
|
||||||
><P
|
|
||||||
></P
|
|
||||||
></DIV
|
|
||||||
><HR><DIV
|
|
||||||
CLASS="REFSECT2"
|
|
||||||
><A
|
|
||||||
NAME="AEN6060"
|
|
||||||
></A
|
|
||||||
><H3
|
|
||||||
><A
|
|
||||||
NAME="XSLTNUMBERDATAPTR"
|
|
||||||
></A
|
|
||||||
>xsltNumberDataPtr</H3
|
|
||||||
><TABLE
|
|
||||||
BORDER="0"
|
|
||||||
BGCOLOR="#D6E8FF"
|
|
||||||
WIDTH="100%"
|
|
||||||
CELLPADDING="6"
|
|
||||||
><TR
|
|
||||||
><TD
|
|
||||||
><PRE
|
|
||||||
CLASS="PROGRAMLISTING"
|
|
||||||
>typedef xsltNumberData *xsltNumberDataPtr;</PRE
|
|
||||||
></TD
|
|
||||||
></TR
|
|
||||||
></TABLE
|
|
||||||
><P
|
|
||||||
></P
|
|
||||||
></DIV
|
|
||||||
><HR><DIV
|
|
||||||
CLASS="REFSECT2"
|
|
||||||
><A
|
|
||||||
NAME="AEN6065"
|
|
||||||
></A
|
|
||||||
><H3
|
|
||||||
><A
|
|
||||||
NAME="XSLTFORMATNUMBERINFO"
|
|
||||||
></A
|
|
||||||
>struct xsltFormatNumberInfo</H3
|
|
||||||
><TABLE
|
|
||||||
BORDER="0"
|
|
||||||
BGCOLOR="#D6E8FF"
|
|
||||||
WIDTH="100%"
|
|
||||||
CELLPADDING="6"
|
|
||||||
><TR
|
|
||||||
><TD
|
|
||||||
><PRE
|
|
||||||
CLASS="PROGRAMLISTING"
|
|
||||||
>struct xsltFormatNumberInfo {
|
|
||||||
int integer_hash; /* Number of '#' in integer part */
|
|
||||||
int integer_digits; /* Number of '0' in integer part */
|
|
||||||
int frac_digits; /* Number of '0' in fractional part */
|
|
||||||
int frac_hash; /* Number of '#' in fractional part */
|
|
||||||
int group; /* Number of chars per display 'group' */
|
|
||||||
int multiplier; /* Scaling for percent or permille */
|
|
||||||
char add_decimal; /* Flag for whether decimal point appears in pattern */
|
|
||||||
char is_multiplier_set; /* Flag to catch multiple occurences of percent/permille */
|
|
||||||
char is_negative_pattern;/* Flag for processing -ve prefix/suffix */
|
|
||||||
};</PRE
|
|
||||||
></TD
|
|
||||||
></TR
|
|
||||||
></TABLE
|
|
||||||
><P
|
|
||||||
>This data structure lists the various parameters needed to format numbers.</P
|
|
||||||
><P
|
|
||||||
></P
|
|
||||||
></DIV
|
|
||||||
><HR><DIV
|
|
||||||
CLASS="REFSECT2"
|
|
||||||
><A
|
|
||||||
NAME="AEN6071"
|
|
||||||
></A
|
|
||||||
><H3
|
|
||||||
><A
|
|
||||||
NAME="XSLTFORMATNUMBERINFOPTR"
|
|
||||||
></A
|
|
||||||
>xsltFormatNumberInfoPtr</H3
|
|
||||||
><TABLE
|
|
||||||
BORDER="0"
|
|
||||||
BGCOLOR="#D6E8FF"
|
|
||||||
WIDTH="100%"
|
|
||||||
CELLPADDING="6"
|
|
||||||
><TR
|
|
||||||
><TD
|
|
||||||
><PRE
|
|
||||||
CLASS="PROGRAMLISTING"
|
|
||||||
>typedef xsltFormatNumberInfo *xsltFormatNumberInfoPtr;</PRE
|
|
||||||
></TD
|
|
||||||
></TR
|
|
||||||
></TABLE
|
|
||||||
><P
|
|
||||||
></P
|
|
||||||
></DIV
|
|
||||||
></DIV
|
|
||||||
><DIV
|
|
||||||
CLASS="NAVFOOTER"
|
|
||||||
><BR
|
|
||||||
CLEAR="all"><BR><TABLE
|
|
||||||
WIDTH="100%"
|
|
||||||
BORDER="0"
|
|
||||||
BGCOLOR="#000000"
|
|
||||||
CELLPADDING="1"
|
|
||||||
CELLSPACING="0"
|
|
||||||
><TR
|
|
||||||
><TD
|
|
||||||
WIDTH="25%"
|
|
||||||
BGCOLOR="#C00000"
|
|
||||||
ALIGN="left"
|
|
||||||
><A
|
|
||||||
HREF="libxslt-xsltinternals.html"
|
|
||||||
><FONT
|
|
||||||
COLOR="#FFFFFF"
|
|
||||||
SIZE="3"
|
|
||||||
><B
|
|
||||||
><<< Previous Page</B
|
|
||||||
></FONT
|
|
||||||
></A
|
|
||||||
></TD
|
|
||||||
><TD
|
|
||||||
WIDTH="25%"
|
|
||||||
BGCOLOR="#0000C0"
|
|
||||||
ALIGN="center"
|
|
||||||
><FONT
|
|
||||||
COLOR="#FFFFFF"
|
|
||||||
SIZE="3"
|
|
||||||
><B
|
|
||||||
><A
|
|
||||||
HREF="book1.html"
|
|
||||||
><FONT
|
|
||||||
COLOR="#FFFFFF"
|
|
||||||
SIZE="3"
|
|
||||||
><B
|
|
||||||
>Home</B
|
|
||||||
></FONT
|
|
||||||
></A
|
|
||||||
></B
|
|
||||||
></FONT
|
|
||||||
></TD
|
|
||||||
><TD
|
|
||||||
WIDTH="25%"
|
|
||||||
BGCOLOR="#00C000"
|
|
||||||
ALIGN="center"
|
|
||||||
><FONT
|
|
||||||
COLOR="#FFFFFF"
|
|
||||||
SIZE="3"
|
|
||||||
><B
|
|
||||||
><A
|
|
||||||
HREF="libxslt-lib.html"
|
|
||||||
><FONT
|
|
||||||
COLOR="#FFFFFF"
|
|
||||||
SIZE="3"
|
|
||||||
><B
|
|
||||||
>Up</B
|
|
||||||
></FONT
|
|
||||||
></A
|
|
||||||
></B
|
|
||||||
></FONT
|
|
||||||
></TD
|
|
||||||
><TD
|
|
||||||
WIDTH="25%"
|
|
||||||
BGCOLOR="#C00000"
|
|
||||||
ALIGN="right"
|
|
||||||
> </TD
|
|
||||||
></TR
|
|
||||||
><TR
|
|
||||||
><TD
|
|
||||||
COLSPAN="2"
|
|
||||||
ALIGN="left"
|
|
||||||
><FONT
|
|
||||||
COLOR="#FFFFFF"
|
|
||||||
SIZE="3"
|
|
||||||
><B
|
|
||||||
>xsltInternals</B
|
|
||||||
></FONT
|
|
||||||
></TD
|
|
||||||
><TD
|
|
||||||
COLSPAN="2"
|
|
||||||
ALIGN="right"
|
|
||||||
> </TD
|
|
||||||
></TR
|
|
||||||
></TABLE
|
|
||||||
></DIV
|
|
||||||
></BODY
|
|
||||||
></HTML
|
|
||||||
>
|
|
||||||
@ -1,4 +1,3 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
||||||
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>pattern</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>pattern</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
||||||
.synopsis, .classsynopsis {
|
.synopsis, .classsynopsis {
|
||||||
background: #eeeeee;
|
background: #eeeeee;
|
||||||
|
|||||||
@ -1,4 +1,3 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
||||||
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>templates</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>templates</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
||||||
.synopsis, .classsynopsis {
|
.synopsis, .classsynopsis {
|
||||||
background: #eeeeee;
|
background: #eeeeee;
|
||||||
|
|||||||
@ -1,4 +1,3 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
||||||
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>transform</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>transform</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
||||||
.synopsis, .classsynopsis {
|
.synopsis, .classsynopsis {
|
||||||
background: #eeeeee;
|
background: #eeeeee;
|
||||||
|
|||||||
@ -1,4 +1,3 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
||||||
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>variables</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>variables</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
||||||
.synopsis, .classsynopsis {
|
.synopsis, .classsynopsis {
|
||||||
background: #eeeeee;
|
background: #eeeeee;
|
||||||
|
|||||||
@ -1,4 +1,3 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
||||||
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>xslt</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>xslt</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
||||||
.synopsis, .classsynopsis {
|
.synopsis, .classsynopsis {
|
||||||
background: #eeeeee;
|
background: #eeeeee;
|
||||||
|
|||||||
@ -1,4 +1,3 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
||||||
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>xsltInternals</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>xsltInternals</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
||||||
.synopsis, .classsynopsis {
|
.synopsis, .classsynopsis {
|
||||||
background: #eeeeee;
|
background: #eeeeee;
|
||||||
@ -98,6 +97,12 @@ void <a href="libxslt-xsltInternals.html#xsltParseTemplateContent">xsltPa
|
|||||||
<GTKDOCLINK xmlns="http://www.w3.org/TR/xhtml1/transitional" HREF="xmlNodePtr">xmlNodePtr</GTKDOCLINK> templ);
|
<GTKDOCLINK xmlns="http://www.w3.org/TR/xhtml1/transitional" HREF="xmlNodePtr">xmlNodePtr</GTKDOCLINK> templ);
|
||||||
int <a href="libxslt-xsltInternals.html#xsltAllocateExtra">xsltAllocateExtra</a> (<a href="libxslt-xsltInternals.html#xsltStylesheetPtr">xsltStylesheetPtr</a> style);
|
int <a href="libxslt-xsltInternals.html#xsltAllocateExtra">xsltAllocateExtra</a> (<a href="libxslt-xsltInternals.html#xsltStylesheetPtr">xsltStylesheetPtr</a> style);
|
||||||
int <a href="libxslt-xsltInternals.html#xsltAllocateExtraCtxt">xsltAllocateExtraCtxt</a> (<a href="libxslt-xsltInternals.html#xsltTransformContextPtr">xsltTransformContextPtr</a> ctxt);
|
int <a href="libxslt-xsltInternals.html#xsltAllocateExtraCtxt">xsltAllocateExtraCtxt</a> (<a href="libxslt-xsltInternals.html#xsltTransformContextPtr">xsltTransformContextPtr</a> ctxt);
|
||||||
|
<GTKDOCLINK xmlns="http://www.w3.org/TR/xhtml1/transitional" HREF="xmlDocPtr">xmlDocPtr</GTKDOCLINK> <a href="libxslt-xsltInternals.html#xsltCreateRVT">xsltCreateRVT</a> (<a href="libxslt-xsltInternals.html#xsltTransformContextPtr">xsltTransformContextPtr</a> ctxt);
|
||||||
|
int <a href="libxslt-xsltInternals.html#xsltRegisterTmpRVT">xsltRegisterTmpRVT</a> (<a href="libxslt-xsltInternals.html#xsltTransformContextPtr">xsltTransformContextPtr</a> ctxt,
|
||||||
|
<GTKDOCLINK xmlns="http://www.w3.org/TR/xhtml1/transitional" HREF="xmlDocPtr">xmlDocPtr</GTKDOCLINK> RVT);
|
||||||
|
int <a href="libxslt-xsltInternals.html#xsltRegisterPersistRVT">xsltRegisterPersistRVT</a> (<a href="libxslt-xsltInternals.html#xsltTransformContextPtr">xsltTransformContextPtr</a> ctxt,
|
||||||
|
<GTKDOCLINK xmlns="http://www.w3.org/TR/xhtml1/transitional" HREF="xmlDocPtr">xmlDocPtr</GTKDOCLINK> RVT);
|
||||||
|
void <a href="libxslt-xsltInternals.html#xsltFreeRVTs">xsltFreeRVTs</a> (<a href="libxslt-xsltInternals.html#xsltTransformContextPtr">xsltTransformContextPtr</a> ctxt);
|
||||||
</pre></div><div class="refsect1" lang="en"><h2>Description</h2><p>
|
</pre></div><div class="refsect1" lang="en"><h2>Description</h2><p>
|
||||||
|
|
||||||
</p></div><div class="refsect1" lang="en"><h2>Details</h2><div class="refsect2" lang="en"><h3><a name="XSLT-MAX-SORT-CAPS"></a>XSLT_MAX_SORT</h3><pre class="programlisting">#define XSLT_MAX_SORT 15
|
</p></div><div class="refsect1" lang="en"><h2>Details</h2><div class="refsect2" lang="en"><h3><a name="XSLT-MAX-SORT-CAPS"></a>XSLT_MAX_SORT</h3><pre class="programlisting">#define XSLT_MAX_SORT 15
|
||||||
@ -265,6 +270,13 @@ Data structure associated to a parsed document.</p><p>
|
|||||||
void * errctx; /* context for the error handler */
|
void * errctx; /* context for the error handler */
|
||||||
|
|
||||||
xsltSortFunc sortfunc; /* a ctxt specific sort routine */
|
xsltSortFunc sortfunc; /* a ctxt specific sort routine */
|
||||||
|
|
||||||
|
/*
|
||||||
|
* handling of temporary Result Value Tree
|
||||||
|
*/
|
||||||
|
xmlDocPtr tmpRVT; /* list of RVT without persistance */
|
||||||
|
xmlDocPtr persistRVT; /* list of persistant RVTs */
|
||||||
|
int ctxtflags; /* context processing flags */
|
||||||
};
|
};
|
||||||
</pre><p>
|
</pre><p>
|
||||||
|
|
||||||
@ -681,4 +693,27 @@ This make sure there is a slot ready in the transformation context</p><p>
|
|||||||
|
|
||||||
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i><EFBFBD>:</span></td><td> an XSLT transformation context
|
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i><EFBFBD>:</span></td><td> an XSLT transformation context
|
||||||
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>the number of the slot
|
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>the number of the slot
|
||||||
|
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xsltCreateRVT"></a>xsltCreateRVT ()</h3><pre class="programlisting"><GTKDOCLINK xmlns="http://www.w3.org/TR/xhtml1/transitional" HREF="xmlDocPtr">xmlDocPtr</GTKDOCLINK> xsltCreateRVT (<a href="libxslt-xsltInternals.html#xsltTransformContextPtr">xsltTransformContextPtr</a> ctxt);</pre><p>
|
||||||
|
Create a result value tree</p><p>
|
||||||
|
|
||||||
|
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i><EFBFBD>:</span></td><td> an XSLT transformation context
|
||||||
|
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>the result value tree or NULL in case of error
|
||||||
|
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xsltRegisterTmpRVT"></a>xsltRegisterTmpRVT ()</h3><pre class="programlisting">int xsltRegisterTmpRVT (<a href="libxslt-xsltInternals.html#xsltTransformContextPtr">xsltTransformContextPtr</a> ctxt,
|
||||||
|
<GTKDOCLINK xmlns="http://www.w3.org/TR/xhtml1/transitional" HREF="xmlDocPtr">xmlDocPtr</GTKDOCLINK> RVT);</pre><p>
|
||||||
|
Register the result value tree for destruction at the end of the context</p><p>
|
||||||
|
|
||||||
|
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i><EFBFBD>:</span></td><td> an XSLT transformation context
|
||||||
|
</td></tr><tr><td><span class="term"><i><tt>RVT</tt></i><EFBFBD>:</span></td><td> a result value tree
|
||||||
|
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>0 in case of success and -1 in case of error.
|
||||||
|
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xsltRegisterPersistRVT"></a>xsltRegisterPersistRVT ()</h3><pre class="programlisting">int xsltRegisterPersistRVT (<a href="libxslt-xsltInternals.html#xsltTransformContextPtr">xsltTransformContextPtr</a> ctxt,
|
||||||
|
<GTKDOCLINK xmlns="http://www.w3.org/TR/xhtml1/transitional" HREF="xmlDocPtr">xmlDocPtr</GTKDOCLINK> RVT);</pre><p>
|
||||||
|
Register the result value tree for destruction at the end of the processing</p><p>
|
||||||
|
|
||||||
|
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i><EFBFBD>:</span></td><td> an XSLT transformation context
|
||||||
|
</td></tr><tr><td><span class="term"><i><tt>RVT</tt></i><EFBFBD>:</span></td><td> a result value tree
|
||||||
|
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>0 in case of success and -1 in case of error.
|
||||||
|
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xsltFreeRVTs"></a>xsltFreeRVTs ()</h3><pre class="programlisting">void xsltFreeRVTs (<a href="libxslt-xsltInternals.html#xsltTransformContextPtr">xsltTransformContextPtr</a> ctxt);</pre><p>
|
||||||
|
Free all the registered result value tree of the transformation</p><p>
|
||||||
|
|
||||||
|
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i><EFBFBD>:</span></td><td> an XSLT transformation context
|
||||||
</td></tr></tbody></table></div></div></div></div><table xmlns="http://www.w3.org/TR/xhtml1/transitional" class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxslt-keys.html"><b><<<EFBFBD>keys</b></a></td><td align="right"><a accesskey="n" href="libxslt-numbersInternals.html"><b>numbersInternals<EFBFBD>>></b></a></td></tr></table></body></html>
|
</td></tr></tbody></table></div></div></div></div><table xmlns="http://www.w3.org/TR/xhtml1/transitional" class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxslt-keys.html"><b><<<EFBFBD>keys</b></a></td><td align="right"><a accesskey="n" href="libxslt-numbersInternals.html"><b>numbersInternals<EFBFBD>>></b></a></td></tr></table></body></html>
|
||||||
|
|||||||
@ -1,4 +1,3 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
||||||
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>xsltutils</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>xsltutils</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
|
||||||
.synopsis, .classsynopsis {
|
.synopsis, .classsynopsis {
|
||||||
background: #eeeeee;
|
background: #eeeeee;
|
||||||
|
|||||||
@ -1,16 +1,14 @@
|
|||||||
<?xml version="1.0" encoding="ISO-8859-1"?>
|
<?xml version="1.0" encoding="ISO-8859-1"?>
|
||||||
<api name='libxslt'>
|
<api name='libxslt'>
|
||||||
<files>
|
<files>
|
||||||
<file name='extra'>
|
<file name='documents'>
|
||||||
<exports symbol='XSLT_LIBXSLT_NAMESPACE'/>
|
<exports symbol='xsltFindDocument'/>
|
||||||
<exports symbol='XSLT_NORM_SAXON_NAMESPACE'/>
|
<exports symbol='xsltFreeDocuments'/>
|
||||||
<exports symbol='XSLT_SAXON_NAMESPACE'/>
|
<exports symbol='xsltFreeStyleDocuments'/>
|
||||||
<exports symbol='XSLT_XALAN_NAMESPACE'/>
|
<exports symbol='xsltLoadDocument'/>
|
||||||
<exports symbol='XSLT_XT_NAMESPACE'/>
|
<exports symbol='xsltLoadStyleDocument'/>
|
||||||
<exports symbol='xsltDebug'/>
|
<exports symbol='xsltNewDocument'/>
|
||||||
<exports symbol='xsltFunctionNodeSet'/>
|
<exports symbol='xsltNewStyleDocument'/>
|
||||||
<exports symbol='xsltRegisterAllExtras'/>
|
|
||||||
<exports symbol='xsltRegisterExtras'/>
|
|
||||||
</file>
|
</file>
|
||||||
<file name='imports'>
|
<file name='imports'>
|
||||||
<exports symbol='XSLT_GET_IMPORT_INT'/>
|
<exports symbol='XSLT_GET_IMPORT_INT'/>
|
||||||
@ -22,11 +20,40 @@
|
|||||||
<exports symbol='xsltParseStylesheetImport'/>
|
<exports symbol='xsltParseStylesheetImport'/>
|
||||||
<exports symbol='xsltParseStylesheetInclude'/>
|
<exports symbol='xsltParseStylesheetInclude'/>
|
||||||
</file>
|
</file>
|
||||||
<file name='preproc'>
|
<file name='security'>
|
||||||
<exports symbol='xsltDocumentComp'/>
|
<exports symbol='XSLT_SECPREF_CREATE_DIRECTORY'/>
|
||||||
<exports symbol='xsltExtMarker'/>
|
<exports symbol='XSLT_SECPREF_READ_FILE'/>
|
||||||
<exports symbol='xsltFreeStylePreComps'/>
|
<exports symbol='XSLT_SECPREF_READ_NETWORK'/>
|
||||||
<exports symbol='xsltStylePreCompute'/>
|
<exports symbol='XSLT_SECPREF_WRITE_FILE'/>
|
||||||
|
<exports symbol='XSLT_SECPREF_WRITE_NETWORK'/>
|
||||||
|
<exports symbol='xsltCheckRead'/>
|
||||||
|
<exports symbol='xsltCheckWrite'/>
|
||||||
|
<exports symbol='xsltFreeSecurityPrefs'/>
|
||||||
|
<exports symbol='xsltGetDefaultSecurityPrefs'/>
|
||||||
|
<exports symbol='xsltGetSecurityPrefs'/>
|
||||||
|
<exports symbol='xsltNewSecurityPrefs'/>
|
||||||
|
<exports symbol='xsltSecurityAllow'/>
|
||||||
|
<exports symbol='xsltSecurityCheck'/>
|
||||||
|
<exports symbol='xsltSecurityForbid'/>
|
||||||
|
<exports symbol='xsltSecurityOption'/>
|
||||||
|
<exports symbol='xsltSecurityPrefs'/>
|
||||||
|
<exports symbol='xsltSecurityPrefsPtr'/>
|
||||||
|
<exports symbol='xsltSetCtxtSecurityPrefs'/>
|
||||||
|
<exports symbol='xsltSetDefaultSecurityPrefs'/>
|
||||||
|
<exports symbol='xsltSetSecurityPrefs'/>
|
||||||
|
</file>
|
||||||
|
<file name='templates'>
|
||||||
|
<exports symbol='xsltAttrListTemplateProcess'/>
|
||||||
|
<exports symbol='xsltAttrTemplateProcess'/>
|
||||||
|
<exports symbol='xsltAttrTemplateValueProcess'/>
|
||||||
|
<exports symbol='xsltAttrTemplateValueProcessNode'/>
|
||||||
|
<exports symbol='xsltEvalAttrValueTemplate'/>
|
||||||
|
<exports symbol='xsltEvalStaticAttrValueTemplate'/>
|
||||||
|
<exports symbol='xsltEvalTemplateString'/>
|
||||||
|
<exports symbol='xsltEvalXPathPredicate'/>
|
||||||
|
<exports symbol='xsltEvalXPathString'/>
|
||||||
|
<exports symbol='xsltEvalXPathStringNs'/>
|
||||||
|
<exports symbol='xsltTemplateProcess'/>
|
||||||
</file>
|
</file>
|
||||||
<file name='xsltutils'>
|
<file name='xsltutils'>
|
||||||
<exports symbol='IS_XSLT_ELEM'/>
|
<exports symbol='IS_XSLT_ELEM'/>
|
||||||
@ -95,49 +122,24 @@
|
|||||||
<exports symbol='xsltUnparsedEntityURIFunction'/>
|
<exports symbol='xsltUnparsedEntityURIFunction'/>
|
||||||
<exports symbol='xsltXPathFunctionLookup'/>
|
<exports symbol='xsltXPathFunctionLookup'/>
|
||||||
</file>
|
</file>
|
||||||
<file name='security'>
|
<file name='namespaces'>
|
||||||
<exports symbol='XSLT_SECPREF_CREATE_DIRECTORY'/>
|
<exports symbol='xsltCopyNamespace'/>
|
||||||
<exports symbol='XSLT_SECPREF_READ_FILE'/>
|
<exports symbol='xsltCopyNamespaceList'/>
|
||||||
<exports symbol='XSLT_SECPREF_READ_NETWORK'/>
|
<exports symbol='xsltFreeNamespaceAliasHashes'/>
|
||||||
<exports symbol='XSLT_SECPREF_WRITE_FILE'/>
|
<exports symbol='xsltGetNamespace'/>
|
||||||
<exports symbol='XSLT_SECPREF_WRITE_NETWORK'/>
|
<exports symbol='xsltGetSpecialNamespace'/>
|
||||||
<exports symbol='xsltCheckRead'/>
|
<exports symbol='xsltNamespaceAlias'/>
|
||||||
<exports symbol='xsltCheckWrite'/>
|
|
||||||
<exports symbol='xsltFreeSecurityPrefs'/>
|
|
||||||
<exports symbol='xsltGetDefaultSecurityPrefs'/>
|
|
||||||
<exports symbol='xsltGetSecurityPrefs'/>
|
|
||||||
<exports symbol='xsltNewSecurityPrefs'/>
|
|
||||||
<exports symbol='xsltSecurityAllow'/>
|
|
||||||
<exports symbol='xsltSecurityCheck'/>
|
|
||||||
<exports symbol='xsltSecurityForbid'/>
|
|
||||||
<exports symbol='xsltSecurityOption'/>
|
|
||||||
<exports symbol='xsltSecurityPrefs'/>
|
|
||||||
<exports symbol='xsltSecurityPrefsPtr'/>
|
|
||||||
<exports symbol='xsltSetCtxtSecurityPrefs'/>
|
|
||||||
<exports symbol='xsltSetDefaultSecurityPrefs'/>
|
|
||||||
<exports symbol='xsltSetSecurityPrefs'/>
|
|
||||||
</file>
|
</file>
|
||||||
<file name='templates'>
|
<file name='extra'>
|
||||||
<exports symbol='xsltAttrListTemplateProcess'/>
|
<exports symbol='XSLT_LIBXSLT_NAMESPACE'/>
|
||||||
<exports symbol='xsltAttrTemplateProcess'/>
|
<exports symbol='XSLT_NORM_SAXON_NAMESPACE'/>
|
||||||
<exports symbol='xsltAttrTemplateValueProcess'/>
|
<exports symbol='XSLT_SAXON_NAMESPACE'/>
|
||||||
<exports symbol='xsltAttrTemplateValueProcessNode'/>
|
<exports symbol='XSLT_XALAN_NAMESPACE'/>
|
||||||
<exports symbol='xsltEvalAttrValueTemplate'/>
|
<exports symbol='XSLT_XT_NAMESPACE'/>
|
||||||
<exports symbol='xsltEvalStaticAttrValueTemplate'/>
|
<exports symbol='xsltDebug'/>
|
||||||
<exports symbol='xsltEvalTemplateString'/>
|
<exports symbol='xsltFunctionNodeSet'/>
|
||||||
<exports symbol='xsltEvalXPathPredicate'/>
|
<exports symbol='xsltRegisterAllExtras'/>
|
||||||
<exports symbol='xsltEvalXPathString'/>
|
<exports symbol='xsltRegisterExtras'/>
|
||||||
<exports symbol='xsltEvalXPathStringNs'/>
|
|
||||||
<exports symbol='xsltTemplateProcess'/>
|
|
||||||
</file>
|
|
||||||
<file name='documents'>
|
|
||||||
<exports symbol='xsltFindDocument'/>
|
|
||||||
<exports symbol='xsltFreeDocuments'/>
|
|
||||||
<exports symbol='xsltFreeStyleDocuments'/>
|
|
||||||
<exports symbol='xsltLoadDocument'/>
|
|
||||||
<exports symbol='xsltLoadStyleDocument'/>
|
|
||||||
<exports symbol='xsltNewDocument'/>
|
|
||||||
<exports symbol='xsltNewStyleDocument'/>
|
|
||||||
</file>
|
</file>
|
||||||
<file name='xsltInternals'>
|
<file name='xsltInternals'>
|
||||||
<exports symbol='CHECK_STOPPED'/>
|
<exports symbol='CHECK_STOPPED'/>
|
||||||
@ -335,13 +337,11 @@
|
|||||||
<exports symbol='xsltLibxsltVersion'/>
|
<exports symbol='xsltLibxsltVersion'/>
|
||||||
<exports symbol='xsltMaxDepth'/>
|
<exports symbol='xsltMaxDepth'/>
|
||||||
</file>
|
</file>
|
||||||
<file name='namespaces'>
|
<file name='preproc'>
|
||||||
<exports symbol='xsltCopyNamespace'/>
|
<exports symbol='xsltDocumentComp'/>
|
||||||
<exports symbol='xsltCopyNamespaceList'/>
|
<exports symbol='xsltExtMarker'/>
|
||||||
<exports symbol='xsltFreeNamespaceAliasHashes'/>
|
<exports symbol='xsltFreeStylePreComps'/>
|
||||||
<exports symbol='xsltGetNamespace'/>
|
<exports symbol='xsltStylePreCompute'/>
|
||||||
<exports symbol='xsltGetSpecialNamespace'/>
|
|
||||||
<exports symbol='xsltNamespaceAlias'/>
|
|
||||||
</file>
|
</file>
|
||||||
<file name='variables'>
|
<file name='variables'>
|
||||||
<exports symbol='XSLT_REGISTER_VARIABLE_LOOKUP'/>
|
<exports symbol='XSLT_REGISTER_VARIABLE_LOOKUP'/>
|
||||||
@ -751,6 +751,7 @@ informations are stored'/>
|
|||||||
*'/>
|
*'/>
|
||||||
<field name='tmpRVT' type='xmlDocPtr' info=' list of RVT without persistance'/>
|
<field name='tmpRVT' type='xmlDocPtr' info=' list of RVT without persistance'/>
|
||||||
<field name='persistRVT' type='xmlDocPtr' info=' list of persistant RVTs'/>
|
<field name='persistRVT' type='xmlDocPtr' info=' list of persistant RVTs'/>
|
||||||
|
<field name='ctxtflags' type='int' info=' context processing flags'/>
|
||||||
</struct>
|
</struct>
|
||||||
<typedef name='xsltTransformContextPtr' file='xsltInternals' type='xsltTransformContext *'/>
|
<typedef name='xsltTransformContextPtr' file='xsltInternals' type='xsltTransformContext *'/>
|
||||||
<typedef name='xsltTransformState' file='xsltInternals' type='enum'/>
|
<typedef name='xsltTransformState' file='xsltInternals' type='enum'/>
|
||||||
|
|||||||
@ -1,14 +1,14 @@
|
|||||||
<MACRO>
|
<MACRO>
|
||||||
<NAME>LIBXSLT_DOTTED_VERSION</NAME>
|
<NAME>LIBXSLT_DOTTED_VERSION</NAME>
|
||||||
#define LIBXSLT_DOTTED_VERSION "1.0.29"
|
#define LIBXSLT_DOTTED_VERSION "1.0.30"
|
||||||
</MACRO>
|
</MACRO>
|
||||||
<MACRO>
|
<MACRO>
|
||||||
<NAME>LIBXSLT_VERSION</NAME>
|
<NAME>LIBXSLT_VERSION</NAME>
|
||||||
#define LIBXSLT_VERSION 10029
|
#define LIBXSLT_VERSION 10030
|
||||||
</MACRO>
|
</MACRO>
|
||||||
<MACRO>
|
<MACRO>
|
||||||
<NAME>LIBXSLT_VERSION_STRING</NAME>
|
<NAME>LIBXSLT_VERSION_STRING</NAME>
|
||||||
#define LIBXSLT_VERSION_STRING "10029"
|
#define LIBXSLT_VERSION_STRING "10030"
|
||||||
</MACRO>
|
</MACRO>
|
||||||
<MACRO>
|
<MACRO>
|
||||||
<NAME>WITH_XSLT_DEBUG</NAME>
|
<NAME>WITH_XSLT_DEBUG</NAME>
|
||||||
@ -1150,15 +1150,15 @@ void
|
|||||||
</FUNCTION>
|
</FUNCTION>
|
||||||
<MACRO>
|
<MACRO>
|
||||||
<NAME>LIBXSLT_DOTTED_VERSION</NAME>
|
<NAME>LIBXSLT_DOTTED_VERSION</NAME>
|
||||||
#define LIBXSLT_DOTTED_VERSION "1.0.29"
|
#define LIBXSLT_DOTTED_VERSION "1.0.30"
|
||||||
</MACRO>
|
</MACRO>
|
||||||
<MACRO>
|
<MACRO>
|
||||||
<NAME>LIBXSLT_VERSION</NAME>
|
<NAME>LIBXSLT_VERSION</NAME>
|
||||||
#define LIBXSLT_VERSION 10029
|
#define LIBXSLT_VERSION 10030
|
||||||
</MACRO>
|
</MACRO>
|
||||||
<MACRO>
|
<MACRO>
|
||||||
<NAME>LIBXSLT_VERSION_STRING</NAME>
|
<NAME>LIBXSLT_VERSION_STRING</NAME>
|
||||||
#define LIBXSLT_VERSION_STRING "10029"
|
#define LIBXSLT_VERSION_STRING "10030"
|
||||||
</MACRO>
|
</MACRO>
|
||||||
<MACRO>
|
<MACRO>
|
||||||
<NAME>WITH_XSLT_DEBUG</NAME>
|
<NAME>WITH_XSLT_DEBUG</NAME>
|
||||||
@ -1293,417 +1293,6 @@ typedef int (*trio_instream_t) TRIO_PROTO((trio_pointer_t));
|
|||||||
#define vdscanf trio_vdscanf
|
#define vdscanf trio_vdscanf
|
||||||
</MACRO>
|
</MACRO>
|
||||||
<MACRO>
|
<MACRO>
|
||||||
<NAME>TRIO_COMPILER_GCC</NAME>
|
|
||||||
# define TRIO_COMPILER_GCC
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_COMPILER_SUNPRO</NAME>
|
|
||||||
# define TRIO_COMPILER_SUNPRO
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_COMPILER_SUNPRO</NAME>
|
|
||||||
# define TRIO_COMPILER_SUNPRO
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_COMPILER_XLC</NAME>
|
|
||||||
# define TRIO_COMPILER_XLC
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_COMPILER_XLC</NAME>
|
|
||||||
# define TRIO_COMPILER_XLC /* Workaround for old xlc */
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_COMPILER_DECC</NAME>
|
|
||||||
# define TRIO_COMPILER_DECC
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_COMPILER_DECC</NAME>
|
|
||||||
# define TRIO_COMPILER_DECC /* Workaround for old DEC C compilers */
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_COMPILER_MSVC</NAME>
|
|
||||||
# define TRIO_COMPILER_MSVC
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_COMPILER_BCB</NAME>
|
|
||||||
# define TRIO_COMPILER_BCB
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_PLATFORM_VMS</NAME>
|
|
||||||
# define TRIO_PLATFORM_VMS
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_PLATFORM_UNIX</NAME>
|
|
||||||
# define TRIO_PLATFORM_UNIX
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_PLATFORM_UNIX</NAME>
|
|
||||||
# define TRIO_PLATFORM_UNIX
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_PLATFORM_UNIX</NAME>
|
|
||||||
# define TRIO_PLATFORM_UNIX
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_PLATFORM_UNIX</NAME>
|
|
||||||
# define TRIO_PLATFORM_UNIX
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_PLATFORM_UNIX</NAME>
|
|
||||||
# define TRIO_PLATFORM_UNIX
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_PLATFORM_QNX</NAME>
|
|
||||||
# define TRIO_PLATFORM_QNX
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_PLATFORM_UNIX</NAME>
|
|
||||||
# define TRIO_PLATFORM_UNIX
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_PLATFORM_UNIX</NAME>
|
|
||||||
# define TRIO_PLATFORM_UNIX
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_PLATFORM_WIN32</NAME>
|
|
||||||
# define TRIO_PLATFORM_WIN32
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_PLATFORM_MPEIX</NAME>
|
|
||||||
# define TRIO_PLATFORM_MPEIX
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_PLATFORM_AIX</NAME>
|
|
||||||
# define TRIO_PLATFORM_AIX
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_PLATFORM_HPUX</NAME>
|
|
||||||
# define TRIO_PLATFORM_HPUX
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_PLATFORM_SOLARIS</NAME>
|
|
||||||
# define TRIO_PLATFORM_SOLARIS
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_PLATFORM_SUNOS</NAME>
|
|
||||||
# define TRIO_PLATFORM_SUNOS
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_COMPILER_SUPPORTS_C89</NAME>
|
|
||||||
# define TRIO_COMPILER_SUPPORTS_C89
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_COMPILER_SUPPORTS_C90</NAME>
|
|
||||||
# define TRIO_COMPILER_SUPPORTS_C90
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_COMPILER_SUPPORTS_C94</NAME>
|
|
||||||
# define TRIO_COMPILER_SUPPORTS_C94
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_COMPILER_SUPPORTS_C99</NAME>
|
|
||||||
# define TRIO_COMPILER_SUPPORTS_C99
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_COMPILER_SUPPORTS_C94</NAME>
|
|
||||||
# define TRIO_COMPILER_SUPPORTS_C94
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_COMPILER_SUPPORTS_UNIX95</NAME>
|
|
||||||
# define TRIO_COMPILER_SUPPORTS_UNIX95
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_COMPILER_SUPPORTS_UNIX98</NAME>
|
|
||||||
# define TRIO_COMPILER_SUPPORTS_UNIX98
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_COMPILER_SUPPORTS_UNIX01</NAME>
|
|
||||||
# define TRIO_COMPILER_SUPPORTS_UNIX01
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_PUBLIC</NAME>
|
|
||||||
# define TRIO_PUBLIC
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_PRIVATE</NAME>
|
|
||||||
# define TRIO_PRIVATE static
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_COMPILER_ANCIENT</NAME>
|
|
||||||
# define TRIO_COMPILER_ANCIENT
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_CONST</NAME>
|
|
||||||
# define TRIO_CONST
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_VOLATILE</NAME>
|
|
||||||
# define TRIO_VOLATILE
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_SIGNED</NAME>
|
|
||||||
# define TRIO_SIGNED
|
|
||||||
</MACRO>
|
|
||||||
<TYPEDEF>
|
|
||||||
<NAME>trio_long_double_t</NAME>
|
|
||||||
typedef double trio_long_double_t;
|
|
||||||
</TYPEDEF>
|
|
||||||
<TYPEDEF>
|
|
||||||
<NAME>trio_pointer_t</NAME>
|
|
||||||
typedef char * trio_pointer_t;
|
|
||||||
</TYPEDEF>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_SUFFIX_LONG</NAME>
|
|
||||||
# define TRIO_SUFFIX_LONG(x) x
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_PROTO</NAME>
|
|
||||||
# define TRIO_PROTO(x) ()
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_NOARGS</NAME>
|
|
||||||
# define TRIO_NOARGS
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_ARGS1</NAME>
|
|
||||||
# define TRIO_ARGS1(list,a1) list a1;
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_ARGS2</NAME>
|
|
||||||
# define TRIO_ARGS2(list,a1,a2) list a1; a2;
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_ARGS3</NAME>
|
|
||||||
# define TRIO_ARGS3(list,a1,a2,a3) list a1; a2; a3;
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_ARGS4</NAME>
|
|
||||||
# define TRIO_ARGS4(list,a1,a2,a3,a4) list a1; a2; a3; a4;
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_ARGS5</NAME>
|
|
||||||
# define TRIO_ARGS5(list,a1,a2,a3,a4,a5) list a1; a2; a3; a4; a5;
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_ARGS6</NAME>
|
|
||||||
# define TRIO_ARGS6(list,a1,a2,a3,a4,a5,a6) list a1; a2; a3; a4; a5; a6;
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_VARGS2</NAME>
|
|
||||||
# define TRIO_VARGS2(list,a1,a2) list a1; a2
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_VARGS3</NAME>
|
|
||||||
# define TRIO_VARGS3(list,a1,a2,a3) list a1; a2; a3
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_VARGS4</NAME>
|
|
||||||
# define TRIO_VARGS4(list,a1,a2,a3,a4) list a1; a2; a3; a4
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_VARGS5</NAME>
|
|
||||||
# define TRIO_VARGS5(list,a1,a2,a3,a4,a5) list a1; a2; a3; a4; a5
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_VA_DECL</NAME>
|
|
||||||
# define TRIO_VA_DECL va_dcl
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_VA_START</NAME>
|
|
||||||
# define TRIO_VA_START(x,y) va_start(x)
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_VA_END</NAME>
|
|
||||||
# define TRIO_VA_END(x) va_end(x)
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_CONST</NAME>
|
|
||||||
# define TRIO_CONST const
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_VOLATILE</NAME>
|
|
||||||
# define TRIO_VOLATILE volatile
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_SIGNED</NAME>
|
|
||||||
# define TRIO_SIGNED signed
|
|
||||||
</MACRO>
|
|
||||||
<TYPEDEF>
|
|
||||||
<NAME>trio_long_double_t</NAME>
|
|
||||||
typedef long double trio_long_double_t;
|
|
||||||
</TYPEDEF>
|
|
||||||
<TYPEDEF>
|
|
||||||
<NAME>trio_pointer_t</NAME>
|
|
||||||
typedef void * trio_pointer_t;
|
|
||||||
</TYPEDEF>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_SUFFIX_LONG</NAME>
|
|
||||||
# define TRIO_SUFFIX_LONG(x) x ## L
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_PROTO</NAME>
|
|
||||||
# define TRIO_PROTO(x) x
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_NOARGS</NAME>
|
|
||||||
# define TRIO_NOARGS void
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_ARGS1</NAME>
|
|
||||||
# define TRIO_ARGS1(list,a1) (a1)
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_ARGS2</NAME>
|
|
||||||
# define TRIO_ARGS2(list,a1,a2) (a1,a2)
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_ARGS3</NAME>
|
|
||||||
# define TRIO_ARGS3(list,a1,a2,a3) (a1,a2,a3)
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_ARGS4</NAME>
|
|
||||||
# define TRIO_ARGS4(list,a1,a2,a3,a4) (a1,a2,a3,a4)
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_ARGS5</NAME>
|
|
||||||
# define TRIO_ARGS5(list,a1,a2,a3,a4,a5) (a1,a2,a3,a4,a5)
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_ARGS6</NAME>
|
|
||||||
# define TRIO_ARGS6(list,a1,a2,a3,a4,a5,a6) (a1,a2,a3,a4,a5,a6)
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_VARGS2</NAME>
|
|
||||||
# define TRIO_VARGS2 TRIO_ARGS2
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_VARGS3</NAME>
|
|
||||||
# define TRIO_VARGS3 TRIO_ARGS3
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_VARGS4</NAME>
|
|
||||||
# define TRIO_VARGS4 TRIO_ARGS4
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_VARGS5</NAME>
|
|
||||||
# define TRIO_VARGS5 TRIO_ARGS5
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_VA_DECL</NAME>
|
|
||||||
# define TRIO_VA_DECL ...
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_VA_START</NAME>
|
|
||||||
# define TRIO_VA_START(x,y) va_start(x,y)
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_VA_END</NAME>
|
|
||||||
# define TRIO_VA_END(x) va_end(x)
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_INLINE</NAME>
|
|
||||||
# define TRIO_INLINE inline
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_INLINE</NAME>
|
|
||||||
# define TRIO_INLINE __inline__
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_INLINE</NAME>
|
|
||||||
# define TRIO_INLINE _inline
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_INLINE</NAME>
|
|
||||||
# define TRIO_INLINE __inline
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_INLINE</NAME>
|
|
||||||
# define TRIO_INLINE
|
|
||||||
</MACRO>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>TRIO_COMPILER_SUPPORTS_LL</NAME>
|
|
||||||
# define TRIO_COMPILER_SUPPORTS_LL
|
|
||||||
</MACRO>
|
|
||||||
<STRUCT>
|
|
||||||
<NAME>xsltSecurityPrefs</NAME>
|
|
||||||
</STRUCT>
|
|
||||||
<TYPEDEF>
|
|
||||||
<NAME>xsltSecurityPrefsPtr</NAME>
|
|
||||||
typedef xsltSecurityPrefs *xsltSecurityPrefsPtr;
|
|
||||||
</TYPEDEF>
|
|
||||||
<ENUM>
|
|
||||||
<NAME>xsltSecurityOption</NAME>
|
|
||||||
typedef enum {
|
|
||||||
XSLT_SECPREF_READ_FILE = 1,
|
|
||||||
XSLT_SECPREF_WRITE_FILE,
|
|
||||||
XSLT_SECPREF_CREATE_DIRECTORY,
|
|
||||||
XSLT_SECPREF_READ_NETWORK,
|
|
||||||
XSLT_SECPREF_WRITE_NETWORK
|
|
||||||
} xsltSecurityOption;
|
|
||||||
</ENUM>
|
|
||||||
<USER_FUNCTION>
|
|
||||||
<NAME>xsltSecurityCheck</NAME>
|
|
||||||
<RETURNS>int </RETURNS>
|
|
||||||
xsltSecurityPrefsPtr sec,
|
|
||||||
xsltTransformContextPtr ctxt,
|
|
||||||
const char *value
|
|
||||||
</USER_FUNCTION>
|
|
||||||
<FUNCTION>
|
|
||||||
<NAME>xsltNewSecurityPrefs</NAME>
|
|
||||||
<RETURNS>xsltSecurityPrefsPtr </RETURNS>
|
|
||||||
void
|
|
||||||
</FUNCTION>
|
|
||||||
<FUNCTION>
|
|
||||||
<NAME>xsltFreeSecurityPrefs</NAME>
|
|
||||||
<RETURNS>void </RETURNS>
|
|
||||||
xsltSecurityPrefsPtr sec
|
|
||||||
</FUNCTION>
|
|
||||||
<FUNCTION>
|
|
||||||
<NAME>xsltSetSecurityPrefs</NAME>
|
|
||||||
<RETURNS>int </RETURNS>
|
|
||||||
xsltSecurityPrefsPtr sec,xsltSecurityOption option,xsltSecurityCheck func
|
|
||||||
</FUNCTION>
|
|
||||||
<FUNCTION>
|
|
||||||
<NAME>xsltGetSecurityPrefs</NAME>
|
|
||||||
<RETURNS>xsltSecurityCheck </RETURNS>
|
|
||||||
xsltSecurityPrefsPtr sec,xsltSecurityOption option
|
|
||||||
</FUNCTION>
|
|
||||||
<FUNCTION>
|
|
||||||
<NAME>xsltSetDefaultSecurityPrefs</NAME>
|
|
||||||
<RETURNS>void </RETURNS>
|
|
||||||
xsltSecurityPrefsPtr sec
|
|
||||||
</FUNCTION>
|
|
||||||
<FUNCTION>
|
|
||||||
<NAME>xsltGetDefaultSecurityPrefs</NAME>
|
|
||||||
<RETURNS>xsltSecurityPrefsPtr </RETURNS>
|
|
||||||
void
|
|
||||||
</FUNCTION>
|
|
||||||
<FUNCTION>
|
|
||||||
<NAME>xsltSetCtxtSecurityPrefs</NAME>
|
|
||||||
<RETURNS>int </RETURNS>
|
|
||||||
xsltSecurityPrefsPtr sec,xsltTransformContextPtr ctxt
|
|
||||||
</FUNCTION>
|
|
||||||
<FUNCTION>
|
|
||||||
<NAME>xsltSecurityAllow</NAME>
|
|
||||||
<RETURNS>int </RETURNS>
|
|
||||||
xsltSecurityPrefsPtr sec,xsltTransformContextPtr ctxt,const char *value
|
|
||||||
</FUNCTION>
|
|
||||||
<FUNCTION>
|
|
||||||
<NAME>xsltSecurityForbid</NAME>
|
|
||||||
<RETURNS>int </RETURNS>
|
|
||||||
xsltSecurityPrefsPtr sec,xsltTransformContextPtr ctxt,const char *value
|
|
||||||
</FUNCTION>
|
|
||||||
<FUNCTION>
|
|
||||||
<NAME>xsltCheckWrite</NAME>
|
|
||||||
<RETURNS>int </RETURNS>
|
|
||||||
xsltSecurityPrefsPtr sec,xsltTransformContextPtr ctxt,const xmlChar *URL
|
|
||||||
</FUNCTION>
|
|
||||||
<FUNCTION>
|
|
||||||
<NAME>xsltCheckRead</NAME>
|
|
||||||
<RETURNS>int </RETURNS>
|
|
||||||
xsltSecurityPrefsPtr sec,xsltTransformContextPtr ctxt,const xmlChar *URL
|
|
||||||
</FUNCTION>
|
|
||||||
<MACRO>
|
|
||||||
<NAME>XSLT_MAX_SORT</NAME>
|
<NAME>XSLT_MAX_SORT</NAME>
|
||||||
#define XSLT_MAX_SORT 15
|
#define XSLT_MAX_SORT 15
|
||||||
</MACRO>
|
</MACRO>
|
||||||
@ -2157,6 +1746,13 @@ struct xsltTransformContext {
|
|||||||
void * errctx; /* context for the error handler */
|
void * errctx; /* context for the error handler */
|
||||||
|
|
||||||
xsltSortFunc sortfunc; /* a ctxt specific sort routine */
|
xsltSortFunc sortfunc; /* a ctxt specific sort routine */
|
||||||
|
|
||||||
|
/*
|
||||||
|
* handling of temporary Result Value Tree
|
||||||
|
*/
|
||||||
|
xmlDocPtr tmpRVT; /* list of RVT without persistance */
|
||||||
|
xmlDocPtr persistRVT; /* list of persistant RVTs */
|
||||||
|
int ctxtflags; /* context processing flags */
|
||||||
};
|
};
|
||||||
</STRUCT>
|
</STRUCT>
|
||||||
<MACRO>
|
<MACRO>
|
||||||
@ -2251,3 +1847,434 @@ xsltStylesheetPtr style
|
|||||||
<RETURNS>int </RETURNS>
|
<RETURNS>int </RETURNS>
|
||||||
xsltTransformContextPtr ctxt
|
xsltTransformContextPtr ctxt
|
||||||
</FUNCTION>
|
</FUNCTION>
|
||||||
|
<FUNCTION>
|
||||||
|
<NAME>xsltCreateRVT</NAME>
|
||||||
|
<RETURNS>xmlDocPtr </RETURNS>
|
||||||
|
xsltTransformContextPtr ctxt
|
||||||
|
</FUNCTION>
|
||||||
|
<FUNCTION>
|
||||||
|
<NAME>xsltRegisterTmpRVT</NAME>
|
||||||
|
<RETURNS>int </RETURNS>
|
||||||
|
xsltTransformContextPtr ctxt,xmlDocPtr RVT
|
||||||
|
</FUNCTION>
|
||||||
|
<FUNCTION>
|
||||||
|
<NAME>xsltRegisterPersistRVT</NAME>
|
||||||
|
<RETURNS>int </RETURNS>
|
||||||
|
xsltTransformContextPtr ctxt,xmlDocPtr RVT
|
||||||
|
</FUNCTION>
|
||||||
|
<FUNCTION>
|
||||||
|
<NAME>xsltFreeRVTs</NAME>
|
||||||
|
<RETURNS>void </RETURNS>
|
||||||
|
xsltTransformContextPtr ctxt
|
||||||
|
</FUNCTION>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_COMPILER_GCC</NAME>
|
||||||
|
# define TRIO_COMPILER_GCC
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_COMPILER_SUNPRO</NAME>
|
||||||
|
# define TRIO_COMPILER_SUNPRO
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_COMPILER_SUNPRO</NAME>
|
||||||
|
# define TRIO_COMPILER_SUNPRO
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_COMPILER_XLC</NAME>
|
||||||
|
# define TRIO_COMPILER_XLC
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_COMPILER_XLC</NAME>
|
||||||
|
# define TRIO_COMPILER_XLC /* Workaround for old xlc */
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_COMPILER_DECC</NAME>
|
||||||
|
# define TRIO_COMPILER_DECC
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_COMPILER_DECC</NAME>
|
||||||
|
# define TRIO_COMPILER_DECC /* Workaround for old DEC C compilers */
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_COMPILER_MSVC</NAME>
|
||||||
|
# define TRIO_COMPILER_MSVC
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_COMPILER_BCB</NAME>
|
||||||
|
# define TRIO_COMPILER_BCB
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_PLATFORM_VMS</NAME>
|
||||||
|
# define TRIO_PLATFORM_VMS
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_PLATFORM_UNIX</NAME>
|
||||||
|
# define TRIO_PLATFORM_UNIX
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_PLATFORM_UNIX</NAME>
|
||||||
|
# define TRIO_PLATFORM_UNIX
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_PLATFORM_UNIX</NAME>
|
||||||
|
# define TRIO_PLATFORM_UNIX
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_PLATFORM_UNIX</NAME>
|
||||||
|
# define TRIO_PLATFORM_UNIX
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_PLATFORM_UNIX</NAME>
|
||||||
|
# define TRIO_PLATFORM_UNIX
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_PLATFORM_QNX</NAME>
|
||||||
|
# define TRIO_PLATFORM_QNX
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_PLATFORM_UNIX</NAME>
|
||||||
|
# define TRIO_PLATFORM_UNIX
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_PLATFORM_UNIX</NAME>
|
||||||
|
# define TRIO_PLATFORM_UNIX
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_PLATFORM_WIN32</NAME>
|
||||||
|
# define TRIO_PLATFORM_WIN32
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_PLATFORM_MPEIX</NAME>
|
||||||
|
# define TRIO_PLATFORM_MPEIX
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_PLATFORM_AIX</NAME>
|
||||||
|
# define TRIO_PLATFORM_AIX
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_PLATFORM_HPUX</NAME>
|
||||||
|
# define TRIO_PLATFORM_HPUX
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_PLATFORM_SOLARIS</NAME>
|
||||||
|
# define TRIO_PLATFORM_SOLARIS
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_PLATFORM_SUNOS</NAME>
|
||||||
|
# define TRIO_PLATFORM_SUNOS
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_COMPILER_SUPPORTS_C89</NAME>
|
||||||
|
# define TRIO_COMPILER_SUPPORTS_C89
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_COMPILER_SUPPORTS_C90</NAME>
|
||||||
|
# define TRIO_COMPILER_SUPPORTS_C90
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_COMPILER_SUPPORTS_C94</NAME>
|
||||||
|
# define TRIO_COMPILER_SUPPORTS_C94
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_COMPILER_SUPPORTS_C99</NAME>
|
||||||
|
# define TRIO_COMPILER_SUPPORTS_C99
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_COMPILER_SUPPORTS_C94</NAME>
|
||||||
|
# define TRIO_COMPILER_SUPPORTS_C94
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_COMPILER_SUPPORTS_UNIX95</NAME>
|
||||||
|
# define TRIO_COMPILER_SUPPORTS_UNIX95
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_COMPILER_SUPPORTS_UNIX98</NAME>
|
||||||
|
# define TRIO_COMPILER_SUPPORTS_UNIX98
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_COMPILER_SUPPORTS_UNIX01</NAME>
|
||||||
|
# define TRIO_COMPILER_SUPPORTS_UNIX01
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_PUBLIC</NAME>
|
||||||
|
# define TRIO_PUBLIC
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_PRIVATE</NAME>
|
||||||
|
# define TRIO_PRIVATE static
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_COMPILER_ANCIENT</NAME>
|
||||||
|
# define TRIO_COMPILER_ANCIENT
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_CONST</NAME>
|
||||||
|
# define TRIO_CONST
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_VOLATILE</NAME>
|
||||||
|
# define TRIO_VOLATILE
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_SIGNED</NAME>
|
||||||
|
# define TRIO_SIGNED
|
||||||
|
</MACRO>
|
||||||
|
<TYPEDEF>
|
||||||
|
<NAME>trio_long_double_t</NAME>
|
||||||
|
typedef double trio_long_double_t;
|
||||||
|
</TYPEDEF>
|
||||||
|
<TYPEDEF>
|
||||||
|
<NAME>trio_pointer_t</NAME>
|
||||||
|
typedef char * trio_pointer_t;
|
||||||
|
</TYPEDEF>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_SUFFIX_LONG</NAME>
|
||||||
|
# define TRIO_SUFFIX_LONG(x) x
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_PROTO</NAME>
|
||||||
|
# define TRIO_PROTO(x) ()
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_NOARGS</NAME>
|
||||||
|
# define TRIO_NOARGS
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_ARGS1</NAME>
|
||||||
|
# define TRIO_ARGS1(list,a1) list a1;
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_ARGS2</NAME>
|
||||||
|
# define TRIO_ARGS2(list,a1,a2) list a1; a2;
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_ARGS3</NAME>
|
||||||
|
# define TRIO_ARGS3(list,a1,a2,a3) list a1; a2; a3;
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_ARGS4</NAME>
|
||||||
|
# define TRIO_ARGS4(list,a1,a2,a3,a4) list a1; a2; a3; a4;
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_ARGS5</NAME>
|
||||||
|
# define TRIO_ARGS5(list,a1,a2,a3,a4,a5) list a1; a2; a3; a4; a5;
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_ARGS6</NAME>
|
||||||
|
# define TRIO_ARGS6(list,a1,a2,a3,a4,a5,a6) list a1; a2; a3; a4; a5; a6;
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_VARGS2</NAME>
|
||||||
|
# define TRIO_VARGS2(list,a1,a2) list a1; a2
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_VARGS3</NAME>
|
||||||
|
# define TRIO_VARGS3(list,a1,a2,a3) list a1; a2; a3
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_VARGS4</NAME>
|
||||||
|
# define TRIO_VARGS4(list,a1,a2,a3,a4) list a1; a2; a3; a4
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_VARGS5</NAME>
|
||||||
|
# define TRIO_VARGS5(list,a1,a2,a3,a4,a5) list a1; a2; a3; a4; a5
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_VA_DECL</NAME>
|
||||||
|
# define TRIO_VA_DECL va_dcl
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_VA_START</NAME>
|
||||||
|
# define TRIO_VA_START(x,y) va_start(x)
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_VA_END</NAME>
|
||||||
|
# define TRIO_VA_END(x) va_end(x)
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_CONST</NAME>
|
||||||
|
# define TRIO_CONST const
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_VOLATILE</NAME>
|
||||||
|
# define TRIO_VOLATILE volatile
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_SIGNED</NAME>
|
||||||
|
# define TRIO_SIGNED signed
|
||||||
|
</MACRO>
|
||||||
|
<TYPEDEF>
|
||||||
|
<NAME>trio_long_double_t</NAME>
|
||||||
|
typedef long double trio_long_double_t;
|
||||||
|
</TYPEDEF>
|
||||||
|
<TYPEDEF>
|
||||||
|
<NAME>trio_pointer_t</NAME>
|
||||||
|
typedef void * trio_pointer_t;
|
||||||
|
</TYPEDEF>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_SUFFIX_LONG</NAME>
|
||||||
|
# define TRIO_SUFFIX_LONG(x) x ## L
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_PROTO</NAME>
|
||||||
|
# define TRIO_PROTO(x) x
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_NOARGS</NAME>
|
||||||
|
# define TRIO_NOARGS void
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_ARGS1</NAME>
|
||||||
|
# define TRIO_ARGS1(list,a1) (a1)
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_ARGS2</NAME>
|
||||||
|
# define TRIO_ARGS2(list,a1,a2) (a1,a2)
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_ARGS3</NAME>
|
||||||
|
# define TRIO_ARGS3(list,a1,a2,a3) (a1,a2,a3)
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_ARGS4</NAME>
|
||||||
|
# define TRIO_ARGS4(list,a1,a2,a3,a4) (a1,a2,a3,a4)
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_ARGS5</NAME>
|
||||||
|
# define TRIO_ARGS5(list,a1,a2,a3,a4,a5) (a1,a2,a3,a4,a5)
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_ARGS6</NAME>
|
||||||
|
# define TRIO_ARGS6(list,a1,a2,a3,a4,a5,a6) (a1,a2,a3,a4,a5,a6)
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_VARGS2</NAME>
|
||||||
|
# define TRIO_VARGS2 TRIO_ARGS2
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_VARGS3</NAME>
|
||||||
|
# define TRIO_VARGS3 TRIO_ARGS3
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_VARGS4</NAME>
|
||||||
|
# define TRIO_VARGS4 TRIO_ARGS4
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_VARGS5</NAME>
|
||||||
|
# define TRIO_VARGS5 TRIO_ARGS5
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_VA_DECL</NAME>
|
||||||
|
# define TRIO_VA_DECL ...
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_VA_START</NAME>
|
||||||
|
# define TRIO_VA_START(x,y) va_start(x,y)
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_VA_END</NAME>
|
||||||
|
# define TRIO_VA_END(x) va_end(x)
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_INLINE</NAME>
|
||||||
|
# define TRIO_INLINE inline
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_INLINE</NAME>
|
||||||
|
# define TRIO_INLINE __inline__
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_INLINE</NAME>
|
||||||
|
# define TRIO_INLINE _inline
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_INLINE</NAME>
|
||||||
|
# define TRIO_INLINE __inline
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_INLINE</NAME>
|
||||||
|
# define TRIO_INLINE
|
||||||
|
</MACRO>
|
||||||
|
<MACRO>
|
||||||
|
<NAME>TRIO_COMPILER_SUPPORTS_LL</NAME>
|
||||||
|
# define TRIO_COMPILER_SUPPORTS_LL
|
||||||
|
</MACRO>
|
||||||
|
<STRUCT>
|
||||||
|
<NAME>xsltSecurityPrefs</NAME>
|
||||||
|
</STRUCT>
|
||||||
|
<TYPEDEF>
|
||||||
|
<NAME>xsltSecurityPrefsPtr</NAME>
|
||||||
|
typedef xsltSecurityPrefs *xsltSecurityPrefsPtr;
|
||||||
|
</TYPEDEF>
|
||||||
|
<ENUM>
|
||||||
|
<NAME>xsltSecurityOption</NAME>
|
||||||
|
typedef enum {
|
||||||
|
XSLT_SECPREF_READ_FILE = 1,
|
||||||
|
XSLT_SECPREF_WRITE_FILE,
|
||||||
|
XSLT_SECPREF_CREATE_DIRECTORY,
|
||||||
|
XSLT_SECPREF_READ_NETWORK,
|
||||||
|
XSLT_SECPREF_WRITE_NETWORK
|
||||||
|
} xsltSecurityOption;
|
||||||
|
</ENUM>
|
||||||
|
<USER_FUNCTION>
|
||||||
|
<NAME>xsltSecurityCheck</NAME>
|
||||||
|
<RETURNS>int </RETURNS>
|
||||||
|
xsltSecurityPrefsPtr sec,
|
||||||
|
xsltTransformContextPtr ctxt,
|
||||||
|
const char *value
|
||||||
|
</USER_FUNCTION>
|
||||||
|
<FUNCTION>
|
||||||
|
<NAME>xsltNewSecurityPrefs</NAME>
|
||||||
|
<RETURNS>xsltSecurityPrefsPtr </RETURNS>
|
||||||
|
void
|
||||||
|
</FUNCTION>
|
||||||
|
<FUNCTION>
|
||||||
|
<NAME>xsltFreeSecurityPrefs</NAME>
|
||||||
|
<RETURNS>void </RETURNS>
|
||||||
|
xsltSecurityPrefsPtr sec
|
||||||
|
</FUNCTION>
|
||||||
|
<FUNCTION>
|
||||||
|
<NAME>xsltSetSecurityPrefs</NAME>
|
||||||
|
<RETURNS>int </RETURNS>
|
||||||
|
xsltSecurityPrefsPtr sec,xsltSecurityOption option,xsltSecurityCheck func
|
||||||
|
</FUNCTION>
|
||||||
|
<FUNCTION>
|
||||||
|
<NAME>xsltGetSecurityPrefs</NAME>
|
||||||
|
<RETURNS>xsltSecurityCheck </RETURNS>
|
||||||
|
xsltSecurityPrefsPtr sec,xsltSecurityOption option
|
||||||
|
</FUNCTION>
|
||||||
|
<FUNCTION>
|
||||||
|
<NAME>xsltSetDefaultSecurityPrefs</NAME>
|
||||||
|
<RETURNS>void </RETURNS>
|
||||||
|
xsltSecurityPrefsPtr sec
|
||||||
|
</FUNCTION>
|
||||||
|
<FUNCTION>
|
||||||
|
<NAME>xsltGetDefaultSecurityPrefs</NAME>
|
||||||
|
<RETURNS>xsltSecurityPrefsPtr </RETURNS>
|
||||||
|
void
|
||||||
|
</FUNCTION>
|
||||||
|
<FUNCTION>
|
||||||
|
<NAME>xsltSetCtxtSecurityPrefs</NAME>
|
||||||
|
<RETURNS>int </RETURNS>
|
||||||
|
xsltSecurityPrefsPtr sec,xsltTransformContextPtr ctxt
|
||||||
|
</FUNCTION>
|
||||||
|
<FUNCTION>
|
||||||
|
<NAME>xsltSecurityAllow</NAME>
|
||||||
|
<RETURNS>int </RETURNS>
|
||||||
|
xsltSecurityPrefsPtr sec,xsltTransformContextPtr ctxt,const char *value
|
||||||
|
</FUNCTION>
|
||||||
|
<FUNCTION>
|
||||||
|
<NAME>xsltSecurityForbid</NAME>
|
||||||
|
<RETURNS>int </RETURNS>
|
||||||
|
xsltSecurityPrefsPtr sec,xsltTransformContextPtr ctxt,const char *value
|
||||||
|
</FUNCTION>
|
||||||
|
<FUNCTION>
|
||||||
|
<NAME>xsltCheckWrite</NAME>
|
||||||
|
<RETURNS>int </RETURNS>
|
||||||
|
xsltSecurityPrefsPtr sec,xsltTransformContextPtr ctxt,const xmlChar *URL
|
||||||
|
</FUNCTION>
|
||||||
|
<FUNCTION>
|
||||||
|
<NAME>xsltCheckRead</NAME>
|
||||||
|
<RETURNS>int </RETURNS>
|
||||||
|
xsltSecurityPrefsPtr sec,xsltTransformContextPtr ctxt,const xmlChar *URL
|
||||||
|
</FUNCTION>
|
||||||
|
|||||||
@ -328,6 +328,62 @@ dscanf
|
|||||||
vdscanf
|
vdscanf
|
||||||
</SECTION>
|
</SECTION>
|
||||||
|
|
||||||
|
<SECTION>
|
||||||
|
<FILE>xsltInternals</FILE>
|
||||||
|
XSLT_MAX_SORT
|
||||||
|
XSLT_PAT_NO_PRIORITY
|
||||||
|
xsltRuntimeExtra
|
||||||
|
xsltRuntimeExtraPtr
|
||||||
|
XSLT_RUNTIME_EXTRA_LST
|
||||||
|
XSLT_RUNTIME_EXTRA_FREE
|
||||||
|
XSLT_RUNTIME_EXTRA
|
||||||
|
xsltTemplate
|
||||||
|
xsltTemplatePtr
|
||||||
|
xsltDecimalFormat
|
||||||
|
xsltDecimalFormatPtr
|
||||||
|
xsltDocument
|
||||||
|
xsltDocumentPtr
|
||||||
|
xsltTransformContext
|
||||||
|
xsltTransformContextPtr
|
||||||
|
xsltElemPreComp
|
||||||
|
xsltElemPreCompPtr
|
||||||
|
xsltTransformFunction
|
||||||
|
xsltSortFunc
|
||||||
|
xsltStyleType
|
||||||
|
xsltElemPreCompDeallocator
|
||||||
|
xsltStylePreComp
|
||||||
|
xsltStylePreCompPtr
|
||||||
|
xsltStackElem
|
||||||
|
xsltStackElemPtr
|
||||||
|
xsltStylesheet
|
||||||
|
xsltStylesheetPtr
|
||||||
|
xsltOutputType
|
||||||
|
xsltTransformState
|
||||||
|
CHECK_STOPPED
|
||||||
|
CHECK_STOPPEDE
|
||||||
|
CHECK_STOPPED0
|
||||||
|
xsltNewStylesheet
|
||||||
|
xsltParseStylesheetFile
|
||||||
|
xsltFreeStylesheet
|
||||||
|
xsltIsBlank
|
||||||
|
xsltFreeStackElemList
|
||||||
|
xsltDecimalFormatGetByName
|
||||||
|
xsltParseStylesheetProcess
|
||||||
|
xsltParseStylesheetOutput
|
||||||
|
xsltParseStylesheetDoc
|
||||||
|
xsltParseStylesheetImportedDoc
|
||||||
|
xsltLoadStylesheetPI
|
||||||
|
xsltNumberFormat
|
||||||
|
xsltFormatNumberConversion
|
||||||
|
xsltParseTemplateContent
|
||||||
|
xsltAllocateExtra
|
||||||
|
xsltAllocateExtraCtxt
|
||||||
|
xsltCreateRVT
|
||||||
|
xsltRegisterTmpRVT
|
||||||
|
xsltRegisterPersistRVT
|
||||||
|
xsltFreeRVTs
|
||||||
|
</SECTION>
|
||||||
|
|
||||||
<SECTION>
|
<SECTION>
|
||||||
<FILE>triodef</FILE>
|
<FILE>triodef</FILE>
|
||||||
TRIO_COMPILER_GCC
|
TRIO_COMPILER_GCC
|
||||||
@ -399,55 +455,3 @@ xsltCheckWrite
|
|||||||
xsltCheckRead
|
xsltCheckRead
|
||||||
</SECTION>
|
</SECTION>
|
||||||
|
|
||||||
<SECTION>
|
|
||||||
<FILE>xsltInternals</FILE>
|
|
||||||
XSLT_MAX_SORT
|
|
||||||
XSLT_PAT_NO_PRIORITY
|
|
||||||
xsltRuntimeExtra
|
|
||||||
xsltRuntimeExtraPtr
|
|
||||||
XSLT_RUNTIME_EXTRA_LST
|
|
||||||
XSLT_RUNTIME_EXTRA_FREE
|
|
||||||
XSLT_RUNTIME_EXTRA
|
|
||||||
xsltTemplate
|
|
||||||
xsltTemplatePtr
|
|
||||||
xsltDecimalFormat
|
|
||||||
xsltDecimalFormatPtr
|
|
||||||
xsltDocument
|
|
||||||
xsltDocumentPtr
|
|
||||||
xsltTransformContext
|
|
||||||
xsltTransformContextPtr
|
|
||||||
xsltElemPreComp
|
|
||||||
xsltElemPreCompPtr
|
|
||||||
xsltTransformFunction
|
|
||||||
xsltSortFunc
|
|
||||||
xsltStyleType
|
|
||||||
xsltElemPreCompDeallocator
|
|
||||||
xsltStylePreComp
|
|
||||||
xsltStylePreCompPtr
|
|
||||||
xsltStackElem
|
|
||||||
xsltStackElemPtr
|
|
||||||
xsltStylesheet
|
|
||||||
xsltStylesheetPtr
|
|
||||||
xsltOutputType
|
|
||||||
xsltTransformState
|
|
||||||
CHECK_STOPPED
|
|
||||||
CHECK_STOPPEDE
|
|
||||||
CHECK_STOPPED0
|
|
||||||
xsltNewStylesheet
|
|
||||||
xsltParseStylesheetFile
|
|
||||||
xsltFreeStylesheet
|
|
||||||
xsltIsBlank
|
|
||||||
xsltFreeStackElemList
|
|
||||||
xsltDecimalFormatGetByName
|
|
||||||
xsltParseStylesheetProcess
|
|
||||||
xsltParseStylesheetOutput
|
|
||||||
xsltParseStylesheetDoc
|
|
||||||
xsltParseStylesheetImportedDoc
|
|
||||||
xsltLoadStylesheetPI
|
|
||||||
xsltNumberFormat
|
|
||||||
xsltFormatNumberConversion
|
|
||||||
xsltParseTemplateContent
|
|
||||||
xsltAllocateExtra
|
|
||||||
xsltAllocateExtraCtxt
|
|
||||||
</SECTION>
|
|
||||||
|
|
||||||
|
|||||||
@ -30,6 +30,6 @@ libexslt_la_SOURCES = \
|
|||||||
libexslt_la_LIBADD = $(INSTALLED_XSLT_LIB) $(EXTRA_LIBS)
|
libexslt_la_LIBADD = $(INSTALLED_XSLT_LIB) $(EXTRA_LIBS)
|
||||||
libexslt_la_LDFLAGS = -version-info @LIBEXSLT_VERSION_INFO@
|
libexslt_la_LDFLAGS = -version-info @LIBEXSLT_VERSION_INFO@
|
||||||
|
|
||||||
man_MANS = libexslt.4
|
man_MANS = libexslt.3
|
||||||
|
|
||||||
EXTRA_DIST = $(man_MANS)
|
EXTRA_DIST = $(man_MANS)
|
||||||
|
|||||||
@ -1,4 +1,4 @@
|
|||||||
.TH libexslt 4 "15 May 2002"
|
.TH libexslt 3 "15 May 2002"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
libexslt \- extension library for XSLT
|
libexslt \- extension library for XSLT
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
@ -101,8 +101,8 @@ static void
|
|||||||
exsltSetsDistinctFunction (xmlXPathParserContextPtr ctxt, int nargs) {
|
exsltSetsDistinctFunction (xmlXPathParserContextPtr ctxt, int nargs) {
|
||||||
xmlXPathObjectPtr obj;
|
xmlXPathObjectPtr obj;
|
||||||
xmlNodeSetPtr ns, ret;
|
xmlNodeSetPtr ns, ret;
|
||||||
int boolval;
|
int boolval = 0;
|
||||||
void *user;
|
void *user = NULL;
|
||||||
|
|
||||||
if (nargs != 1) {
|
if (nargs != 1) {
|
||||||
xmlXPathSetArityError(ctxt);
|
xmlXPathSetArityError(ctxt);
|
||||||
|
|||||||
@ -85,8 +85,8 @@ rm -fr %{buildroot}
|
|||||||
%doc AUTHORS ChangeLog NEWS README Copyright TODO FEATURES
|
%doc AUTHORS ChangeLog NEWS README Copyright TODO FEATURES
|
||||||
%doc doc/libxslt-api.xml
|
%doc doc/libxslt-api.xml
|
||||||
%doc doc/libexslt-api.xml
|
%doc doc/libexslt-api.xml
|
||||||
%doc %{_mandir}/man4/libxslt.4*
|
%doc %{_mandir}/man3/libxslt.3*
|
||||||
%doc %{_mandir}/man4/libexslt.4*
|
%doc %{_mandir}/man3/libexslt.3*
|
||||||
%{_libdir}/lib*.so
|
%{_libdir}/lib*.so
|
||||||
%{_libdir}/*a
|
%{_libdir}/*a
|
||||||
%{_libdir}/*.sh
|
%{_libdir}/*.sh
|
||||||
|
|||||||
@ -51,7 +51,7 @@ libxslt_la_SOURCES = \
|
|||||||
libxslt_la_LIBADD = $(EXTRA_LIBS)
|
libxslt_la_LIBADD = $(EXTRA_LIBS)
|
||||||
libxslt_la_LDFLAGS = -version-info @LIBXSLT_VERSION_INFO@
|
libxslt_la_LDFLAGS = -version-info @LIBXSLT_VERSION_INFO@
|
||||||
|
|
||||||
man_MANS = libxslt.4
|
man_MANS = libxslt.3
|
||||||
|
|
||||||
EXTRA_DIST = $(man_MANS)
|
EXTRA_DIST = $(man_MANS)
|
||||||
|
|
||||||
|
|||||||
@ -504,6 +504,7 @@ struct _xsltTransformContext {
|
|||||||
*/
|
*/
|
||||||
xmlDocPtr tmpRVT; /* list of RVT without persistance */
|
xmlDocPtr tmpRVT; /* list of RVT without persistance */
|
||||||
xmlDocPtr persistRVT; /* list of persistant RVTs */
|
xmlDocPtr persistRVT; /* list of persistant RVTs */
|
||||||
|
int ctxtflags; /* context processing flags */
|
||||||
};
|
};
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
|||||||
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
@ -84,7 +84,7 @@
|
|||||||
irc.gnome.org is another option for contacting GDP members.
|
irc.gnome.org is another option for contacting GDP members.
|
||||||
</p></div></div><div class="sect2"><a name="notation"/><div class="titlepage"><div><h3 class="title"><a name="notation"/>Notation and Conventions</h3></div></div><p>
|
</p></div></div><div class="sect2"><a name="notation"/><div class="titlepage"><div><h3 class="title"><a name="notation"/>Notation and Conventions</h3></div></div><p>
|
||||||
This Handbook uses the following notation:
|
This Handbook uses the following notation:
|
||||||
<div class="informaltable" id="id2880946"><a name="id2880946"/><table border="0"><colgroup><col/><col/></colgroup><tbody><tr><td><tt>/usr/bin</tt></td><td>
|
<div class="informaltable" id="id2797668"><a name="id2797668"/><table border="0"><colgroup><col/><col/></colgroup><tbody><tr><td><tt>/usr/bin</tt></td><td>
|
||||||
Directory
|
Directory
|
||||||
</td></tr><tr><td><tt>foo.sgml</tt></td><td>
|
</td></tr><tr><td><tt>foo.sgml</tt></td><td>
|
||||||
Filename
|
Filename
|
||||||
@ -148,7 +148,7 @@
|
|||||||
help. The <i>DocTable</i> also allows
|
help. The <i>DocTable</i> also allows
|
||||||
people to make announcements and suggestions and to discuss
|
people to make announcements and suggestions and to discuss
|
||||||
issues in the comments section.
|
issues in the comments section.
|
||||||
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2787350"/>Note</h3><p>
|
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2795537"/>Note</h3><p>
|
||||||
Note that the information in the
|
Note that the information in the
|
||||||
<i>DocTable</i> may not always be up-to-date
|
<i>DocTable</i> may not always be up-to-date
|
||||||
or accurate. When you assign yourself to documenting an
|
or accurate. When you assign yourself to documenting an
|
||||||
@ -160,7 +160,7 @@
|
|||||||
this for documentation, not least of which is the single
|
this for documentation, not least of which is the single
|
||||||
source nature of SGML. To contribute to the GDP you should
|
source nature of SGML. To contribute to the GDP you should
|
||||||
learn to use DocBook.
|
learn to use DocBook.
|
||||||
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2787436"/>NOTE</h3><p>
|
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2795620"/>NOTE</h3><p>
|
||||||
To get started writing for the GDP you do not need to rush
|
To get started writing for the GDP you do not need to rush
|
||||||
out and learn DocBook - if you feel it is too much to handle
|
out and learn DocBook - if you feel it is too much to handle
|
||||||
for now, you can submit plain ASCII text to the <a href="http://mail.gnome.org/mailman/listinfo/gnome-doc-list/" target="_top">
|
for now, you can submit plain ASCII text to the <a href="http://mail.gnome.org/mailman/listinfo/gnome-doc-list/" target="_top">
|
||||||
@ -206,14 +206,14 @@
|
|||||||
your output document appearance subtly vary between the two
|
your output document appearance subtly vary between the two
|
||||||
DTD's. To install the GDP custom DTD with PNG image support
|
DTD's. To install the GDP custom DTD with PNG image support
|
||||||
by hand:
|
by hand:
|
||||||
</p><div class="itemizedlist"><ul><li style="list-style-type: opencircle"><p><a name="id2787838"/>
|
</p><div class="itemizedlist"><ul><li style="list-style-type: opencircle"><p><a name="id2796033"/>
|
||||||
Download <a href="http://www.labs.redhat.com/png/png-support.html" target="_top">the
|
Download <a href="http://www.labs.redhat.com/png/png-support.html" target="_top">the
|
||||||
GDP DocBook DTD for PNG support</a> and install it
|
GDP DocBook DTD for PNG support</a> and install it
|
||||||
where you keep your DTD's. (On Red Hat use <tt>/usr/lib/sgml/</tt>.) Note that
|
where you keep your DTD's. (On Red Hat use <tt>/usr/lib/sgml/</tt>.) Note that
|
||||||
the 3.0 DTD is missing support for the
|
the 3.0 DTD is missing support for the
|
||||||
<tt><legalnotice></tt> tag, so it is
|
<tt><legalnotice></tt> tag, so it is
|
||||||
recommended that you use version 3.1
|
recommended that you use version 3.1
|
||||||
</p></li><li style="list-style-type: disc"><p><a name="id2788168"/>
|
</p></li><li style="list-style-type: disc"><p><a name="id2796096"/>
|
||||||
Add the new DTD to your SGML CATALOG file. The location
|
Add the new DTD to your SGML CATALOG file. The location
|
||||||
of your SGML CATALOG file may vary depending upon your
|
of your SGML CATALOG file may vary depending upon your
|
||||||
distribution. (On Red Hat it is usually in
|
distribution. (On Red Hat it is usually in
|
||||||
@ -291,7 +291,7 @@ V1.1//EN"[]>
|
|||||||
the command <tt>$</tt><b>db2ps
|
the command <tt>$</tt><b>db2ps
|
||||||
mydocument.sgml</b>, after which you can print out or
|
mydocument.sgml</b>, after which you can print out or
|
||||||
view the resulting .ps file.
|
view the resulting .ps file.
|
||||||
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2907932"/>NOTE</h3><p>
|
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2796573"/>NOTE</h3><p>
|
||||||
The html files you get will not look quite the same as the
|
The html files you get will not look quite the same as the
|
||||||
documentation distributed with GNOME unless you have the
|
documentation distributed with GNOME unless you have the
|
||||||
custom stylesheets installed on your machine. DocBook
|
custom stylesheets installed on your machine. DocBook
|
||||||
@ -342,24 +342,24 @@ V1.1//EN"[]>
|
|||||||
There are many resources available to help you learn DocBook.
|
There are many resources available to help you learn DocBook.
|
||||||
The following resources on the web are useful for learning
|
The following resources on the web are useful for learning
|
||||||
DocBook:
|
DocBook:
|
||||||
</p><div class="itemizedlist"><ul><li style="list-style-type: disc"><p><a name="id2908222"/>
|
</p><div class="itemizedlist"><ul><li style="list-style-type: disc"><p><a name="id2918692"/>
|
||||||
<a href="http://www.docbook.org" target="_top">http://www.docbook.org</a> - Norman
|
<a href="http://www.docbook.org" target="_top">http://www.docbook.org</a> - Norman
|
||||||
Walsh's <i>DocBook: The Definitive
|
Walsh's <i>DocBook: The Definitive
|
||||||
Guide</i>. Online O'Reilly book on using
|
Guide</i>. Online O'Reilly book on using
|
||||||
DocBook. Contains an excellent element reference. May be
|
DocBook. Contains an excellent element reference. May be
|
||||||
too formal for a beginner.
|
too formal for a beginner.
|
||||||
</p></li><li style="list-style-type: disc"><p><a name="id2908268"/>
|
</p></li><li style="list-style-type: disc"><p><a name="id2918739"/>
|
||||||
<a href="http://www.oswg.org/oswg-nightly/oswg/en_US.ISO_8859-1/articles/DocBook-Intro/docbook-intro/index.html" target="_top">A Practical Introduction to DocBook</a>
|
<a href="http://www.oswg.org/oswg-nightly/oswg/en_US.ISO_8859-1/articles/DocBook-Intro/docbook-intro/index.html" target="_top">A Practical Introduction to DocBook</a>
|
||||||
- The Open Source Writers Group's introduction to using
|
- The Open Source Writers Group's introduction to using
|
||||||
DocBook. This is an excellent HOW-TO type article on
|
DocBook. This is an excellent HOW-TO type article on
|
||||||
getting started.
|
getting started.
|
||||||
</p></li><li style="list-style-type: disc"><p><a name="id2908308"/>
|
</p></li><li style="list-style-type: disc"><p><a name="id2918780"/>
|
||||||
<a href="http://nis-www.lanl.gov/~rosalia/mydocs/docbook-intro/docbook-intro.html" target="_top">Getting Going with DocBook: Notes for
|
<a href="http://nis-www.lanl.gov/~rosalia/mydocs/docbook-intro/docbook-intro.html" target="_top">Getting Going with DocBook: Notes for
|
||||||
Hackers</a> - Mark Galassi's introduction to DocBook
|
Hackers</a> - Mark Galassi's introduction to DocBook
|
||||||
for hackers. This has to be one of the first
|
for hackers. This has to be one of the first
|
||||||
introductions to DocBook ever - still as good as it ever
|
introductions to DocBook ever - still as good as it ever
|
||||||
was.
|
was.
|
||||||
</p></li><li style="list-style-type: disc"><p><a name="id2908348"/>
|
</p></li><li style="list-style-type: disc"><p><a name="id2918819"/>
|
||||||
<a href="http://www.freebsd.org/tutorials/docproj-primer/" target="_top">
|
<a href="http://www.freebsd.org/tutorials/docproj-primer/" target="_top">
|
||||||
FreeBSD Documentation Project Primer for New
|
FreeBSD Documentation Project Primer for New
|
||||||
Contributors</a> - FreeBSD documentation project
|
Contributors</a> - FreeBSD documentation project
|
||||||
@ -372,7 +372,7 @@ V1.1//EN"[]>
|
|||||||
</p><p>
|
</p><p>
|
||||||
The following sections of this document are designed to help
|
The following sections of this document are designed to help
|
||||||
documentation authors write correct and consistent DocBook:
|
documentation authors write correct and consistent DocBook:
|
||||||
</p><div class="itemizedlist"><ul><li style="list-style-type: disc"><p><a name="id2908423"/>
|
</p><div class="itemizedlist"><ul><li style="list-style-type: disc"><p><a name="id2918894"/>
|
||||||
<a href="#docbookbasics" title="DocBook Basics ">the section called “DocBook Basics ”</a> - Descriptions of
|
<a href="#docbookbasics" title="DocBook Basics ">the section called “DocBook Basics ”</a> - Descriptions of
|
||||||
commonly used DocBook tags.
|
commonly used DocBook tags.
|
||||||
</p></li></ul></div><p>
|
</p></li></ul></div><p>
|
||||||
@ -710,7 +710,7 @@ V1.1//EN"[]>
|
|||||||
ready for this transistion, it is <i>strongly
|
ready for this transistion, it is <i>strongly
|
||||||
advised</i> that the documentation writers conform to XML
|
advised</i> that the documentation writers conform to XML
|
||||||
syntax rules. Here are most important differences:
|
syntax rules. Here are most important differences:
|
||||||
</p><div class="variablelist"><dl><dt><a name="id2910860"/><span class="term"> <i>Minimization</i></span></dt><dd><p><a name="id2910878"/>
|
</p><div class="variablelist"><dl><dt><a name="id2921205"/><span class="term"> <i>Minimization</i></span></dt><dd><p><a name="id2921223"/>
|
||||||
It is possible with some implementations of SGML to use
|
It is possible with some implementations of SGML to use
|
||||||
minimizations to close elements in a document by using
|
minimizations to close elements in a document by using
|
||||||
</>, for example:
|
</>, for example:
|
||||||
@ -721,7 +721,7 @@ V1.1//EN"[]>
|
|||||||
if you are using Emacs with psgml
|
if you are using Emacs with psgml
|
||||||
mode, you can also use menu command
|
mode, you can also use menu command
|
||||||
Modify->Normalize.
|
Modify->Normalize.
|
||||||
</p></dd><dt><a name="id2910991"/><span class="term"> <i>Self-closing tags</i></span></dt><dd><p><a name="id2911010"/>
|
</p></dd><dt><a name="id2921339"/><span class="term"> <i>Self-closing tags</i></span></dt><dd><p><a name="id2921357"/>
|
||||||
Also, in SGML some tags are allowed not to have closing
|
Also, in SGML some tags are allowed not to have closing
|
||||||
tags. For example, it is legal for
|
tags. For example, it is legal for
|
||||||
<tt><xref></tt> not to have a closing tag:
|
<tt><xref></tt> not to have a closing tag:
|
||||||
@ -731,7 +731,7 @@ V1.1//EN"[]>
|
|||||||
<tt><tt><xref
|
<tt><tt><xref
|
||||||
linkend="someid"/></tt></tt> (note the
|
linkend="someid"/></tt></tt> (note the
|
||||||
slash!).
|
slash!).
|
||||||
</p></dd><dt><a name="id2911074"/><span class="term"> <i>Case sensitive tags</i></span></dt><dd><p><a name="id2911092"/>
|
</p></dd><dt><a name="id2921424"/><span class="term"> <i>Case sensitive tags</i></span></dt><dd><p><a name="id2921441"/>
|
||||||
In XML, unlike SGML, tags are case-senstive
|
In XML, unlike SGML, tags are case-senstive
|
||||||
<tt><title></tt> and
|
<tt><title></tt> and
|
||||||
<tt><TITLE></tt> are different tags!
|
<tt><TITLE></tt> are different tags!
|
||||||
@ -797,7 +797,7 @@ V1.1//EN"[]>
|
|||||||
actual file name (without extension). The result will look like this:
|
actual file name (without extension). The result will look like this:
|
||||||
|
|
||||||
<div class="figure"><p><a name="shot1"/><b>Figure 1. Screenshot</b></p><div class="screenshot"><p><img src="figures/example_screenshot"/></p></div></div>
|
<div class="figure"><p><a name="shot1"/><b>Figure 1. Screenshot</b></p><div class="screenshot"><p><img src="figures/example_screenshot"/></p></div></div>
|
||||||
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2911611"/>NOTE</h3><p>
|
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2921964"/>NOTE</h3><p>
|
||||||
Notice in this example that the screenshot file name does
|
Notice in this example that the screenshot file name does
|
||||||
not include the file type extension -- to find out
|
not include the file type extension -- to find out
|
||||||
why, please read <a href="#jadeimages" title="Images in DocBook Tools">the section called “Images in DocBook Tools”</a>.
|
why, please read <a href="#jadeimages" title="Images in DocBook Tools">the section called “Images in DocBook Tools”</a>.
|
||||||
@ -845,7 +845,7 @@ make: *** No rule to make target `love'. Stop.
|
|||||||
Note the use of tags <tt><prompt></tt> and
|
Note the use of tags <tt><prompt></tt> and
|
||||||
<tt><userinput></tt> for marking system prompt
|
<tt><userinput></tt> for marking system prompt
|
||||||
and commands entered by user.
|
and commands entered by user.
|
||||||
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2911833"/>NOTE</h3><p>
|
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2922180"/>NOTE</h3><p>
|
||||||
Note that both <tt><programlisting></tt>
|
Note that both <tt><programlisting></tt>
|
||||||
and <tt><screen></tt> preserve linebreaks,
|
and <tt><screen></tt> preserve linebreaks,
|
||||||
but interpret SGML tags (unlike LaTeX
|
but interpret SGML tags (unlike LaTeX
|
||||||
@ -858,7 +858,7 @@ make: *** No rule to make target `love'. Stop.
|
|||||||
<tt><itemizedlist></tt>,
|
<tt><itemizedlist></tt>,
|
||||||
<tt><orderedlist></tt>, and
|
<tt><orderedlist></tt>, and
|
||||||
<tt><variablelist></tt>.
|
<tt><variablelist></tt>.
|
||||||
</p><div class="variablelist"><dl><dt><a name="id2911950"/><span class="term"> <tt><itemizedlist></tt></span></dt><dd><p><a name="id2911969"/>
|
</p><div class="variablelist"><dl><dt><a name="id2922298"/><span class="term"> <tt><itemizedlist></tt></span></dt><dd><p><a name="id2922318"/>
|
||||||
This is the simplest unnumbered list, parallel to
|
This is the simplest unnumbered list, parallel to
|
||||||
<tt><ul></tt> in HTML. Here is an example:
|
<tt><ul></tt> in HTML. Here is an example:
|
||||||
<pre class="programlisting">
|
<pre class="programlisting">
|
||||||
@ -889,16 +889,16 @@ make: *** No rule to make target `love'. Stop.
|
|||||||
|
|
||||||
</pre>
|
</pre>
|
||||||
and output:
|
and output:
|
||||||
</p><div class="itemizedlist"><ul><li><p><a name="id2912012"/>
|
</p><div class="itemizedlist"><ul><li><p><a name="id2922357"/>
|
||||||
Show backup files --
|
Show backup files --
|
||||||
This will show any backup file that might be on
|
This will show any backup file that might be on
|
||||||
your system.
|
your system.
|
||||||
</p></li><li><p><a name="id2912060"/>
|
</p></li><li><p><a name="id2922417"/>
|
||||||
Show hidden files --
|
Show hidden files --
|
||||||
This will show all "dot files" or files that
|
This will show all "dot files" or files that
|
||||||
begin with a dot. This files typically include
|
begin with a dot. This files typically include
|
||||||
configuration files and directories.
|
configuration files and directories.
|
||||||
</p></li><li><p><a name="id2912092"/>
|
</p></li><li><p><a name="id2922449"/>
|
||||||
Mix files and directories
|
Mix files and directories
|
||||||
-- This option will display files and
|
-- This option will display files and
|
||||||
directories in the order you sort them instead
|
directories in the order you sort them instead
|
||||||
@ -915,7 +915,7 @@ make: *** No rule to make target `love'. Stop.
|
|||||||
or -- if none of
|
or -- if none of
|
||||||
this applies -- use
|
this applies -- use
|
||||||
<a href="#gui" title="GUI elements"><tt><emphasis></tt></a>.
|
<a href="#gui" title="GUI elements"><tt><emphasis></tt></a>.
|
||||||
</p></dd><dt><a name="id2912265"/><span class="term"> <tt><orderedlist></tt></span></dt><dd><p><a name="id2912283"/>
|
</p></dd><dt><a name="id2922620"/><span class="term"> <tt><orderedlist></tt></span></dt><dd><p><a name="id2922639"/>
|
||||||
This list is completely analogous to
|
This list is completely analogous to
|
||||||
<tt><itemizedlist></tt> and has the same
|
<tt><itemizedlist></tt> and has the same
|
||||||
syntax, but it produces numbered list. By default,
|
syntax, but it produces numbered list. By default,
|
||||||
@ -928,7 +928,7 @@ make: *** No rule to make target `love'. Stop.
|
|||||||
<tt>loweralpha</tt>,
|
<tt>loweralpha</tt>,
|
||||||
<tt>upperroman</tt>,
|
<tt>upperroman</tt>,
|
||||||
<tt>lowerroman</tt>.
|
<tt>lowerroman</tt>.
|
||||||
</p></dd><dt><a name="id2912363"/><span class="term"> <tt><variablelist></tt></span></dt><dd><p><a name="id2912382"/> This list is used when each entry is
|
</p></dd><dt><a name="id2922720"/><span class="term"> <tt><variablelist></tt></span></dt><dd><p><a name="id2922739"/> This list is used when each entry is
|
||||||
rather long, so it should be formatted as a block of text
|
rather long, so it should be formatted as a block of text
|
||||||
with some subtitle, like a small subsection. The
|
with some subtitle, like a small subsection. The
|
||||||
<tt><variablelist></tt> is more complicated
|
<tt><variablelist></tt> is more complicated
|
||||||
@ -969,25 +969,25 @@ make: *** No rule to make target `love'. Stop.
|
|||||||
are smart enough to change the numeration (for
|
are smart enough to change the numeration (for
|
||||||
<tt><orderedlist></tt>) or marks of each entry
|
<tt><orderedlist></tt>) or marks of each entry
|
||||||
(in <tt><itemizedlist></tt>) for sub-lists
|
(in <tt><itemizedlist></tt>) for sub-lists
|
||||||
</p></div></div><div class="sect2"><a name="inline"/><div class="titlepage"><div><h3 class="title"><a name="inline"/>Inline Elements</h3></div></div><div class="sect3"><a name="gui"/><div class="titlepage"><div><h4 class="title"><a name="gui"/>GUI elements</h4></div></div><div class="itemizedlist"><ul><li><p><a name="id2912542"/>
|
</p></div></div><div class="sect2"><a name="inline"/><div class="titlepage"><div><h3 class="title"><a name="inline"/>Inline Elements</h3></div></div><div class="sect3"><a name="gui"/><div class="titlepage"><div><h4 class="title"><a name="gui"/>GUI elements</h4></div></div><div class="itemizedlist"><ul><li><p><a name="id2922909"/>
|
||||||
<tt><guibutton></tt> -- used for
|
<tt><guibutton></tt> -- used for
|
||||||
buttons, including checkbuttons and radio buttons
|
buttons, including checkbuttons and radio buttons
|
||||||
</p></li><li><p><a name="id2912568"/>
|
</p></li><li><p><a name="id2922935"/>
|
||||||
<tt><guimenu></tt>,
|
<tt><guimenu></tt>,
|
||||||
<tt><guisubmenu></tt> --used for
|
<tt><guisubmenu></tt> --used for
|
||||||
top-level menus and submenus
|
top-level menus and submenus
|
||||||
respectively, for example <tt>
|
respectively, for example <tt>
|
||||||
<guisubmenu>Utilities</guisubmenu> submenu of the
|
<guisubmenu>Utilities</guisubmenu> submenu of the
|
||||||
<guimenu>Main Menu</guimenu></tt>
|
<guimenu>Main Menu</guimenu></tt>
|
||||||
</p></li><li><p><a name="id2912619"/>
|
</p></li><li><p><a name="id2922985"/>
|
||||||
<tt><guimenuitem></tt>--an entry in a
|
<tt><guimenuitem></tt>--an entry in a
|
||||||
menu
|
menu
|
||||||
</p></li><li><p><a name="id2912642"/>
|
</p></li><li><p><a name="id2923009"/>
|
||||||
<tt><guiicon></tt>--an icon
|
<tt><guiicon></tt>--an icon
|
||||||
</p></li><li><p><a name="id2912666"/>
|
</p></li><li><p><a name="id2923034"/>
|
||||||
<tt><guilabel></tt>--for items which have
|
<tt><guilabel></tt>--for items which have
|
||||||
labels, like tabs, or bounding boxes.
|
labels, like tabs, or bounding boxes.
|
||||||
</p></li><li><p><a name="id2912692"/>
|
</p></li><li><p><a name="id2923060"/>
|
||||||
<tt><interface></tt>-- for most everything
|
<tt><interface></tt>-- for most everything
|
||||||
else... a window, a dialog box, the Panel, etc.
|
else... a window, a dialog box, the Panel, etc.
|
||||||
</p></li></ul></div><p>
|
</p></li></ul></div><p>
|
||||||
@ -1035,35 +1035,35 @@ url="http://www.gnome.org">GNOME Web page</ulink>
|
|||||||
computer-related things</h4></div></div><p>
|
computer-related things</h4></div></div><p>
|
||||||
Here are some tags used to describe operating system-related
|
Here are some tags used to describe operating system-related
|
||||||
things:
|
things:
|
||||||
</p><div class="itemizedlist"><ul><li><p><a name="id2913087"/> <tt><filename></tt> -- used
|
</p><div class="itemizedlist"><ul><li><p><a name="id2923447"/> <tt><filename></tt> -- used
|
||||||
for filenames,
|
for filenames,
|
||||||
e.g.<tt><filename></tt>
|
e.g.<tt><filename></tt>
|
||||||
foo.sgml
|
foo.sgml
|
||||||
<tt></filename></tt>
|
<tt></filename></tt>
|
||||||
produces: <tt>foo.sgml</tt>.
|
produces: <tt>foo.sgml</tt>.
|
||||||
</p></li><li><p><a name="id2913141"/> <tt><filename
|
</p></li><li><p><a name="id2923504"/> <tt><filename
|
||||||
class="directory"></tt> -- used for
|
class="directory"></tt> -- used for
|
||||||
directories, e.g.<tt><filename
|
directories, e.g.<tt><filename
|
||||||
class="directory"></tt>/usr/bin
|
class="directory"></tt>/usr/bin
|
||||||
<tt></filename></tt>
|
<tt></filename></tt>
|
||||||
produces: <tt>/usr/bin</tt>.
|
produces: <tt>/usr/bin</tt>.
|
||||||
</p></li><li><p><a name="id2913201"/>
|
</p></li><li><p><a name="id2923567"/>
|
||||||
<tt><application></tt> -- used for
|
<tt><application></tt> -- used for
|
||||||
application names,
|
application names,
|
||||||
e.g. <tt><application></tt>Gnumeric
|
e.g. <tt><application></tt>Gnumeric
|
||||||
<tt></application></tt> produces:
|
<tt></application></tt> produces:
|
||||||
Gnumeric.
|
Gnumeric.
|
||||||
</p></li><li><p><a name="id2913256"/>
|
</p></li><li><p><a name="id2923622"/>
|
||||||
<tt><envar></tt> -- used for
|
<tt><envar></tt> -- used for
|
||||||
environment variables, e.g.
|
environment variables, e.g.
|
||||||
<tt><envar></tt>PATH<tt></envar></tt>.
|
<tt><envar></tt>PATH<tt></envar></tt>.
|
||||||
</p></li><li><p><a name="id2913297"/>
|
</p></li><li><p><a name="id2923664"/>
|
||||||
<tt><command></tt> -- used for
|
<tt><command></tt> -- used for
|
||||||
commands entered on command line, e.g.
|
commands entered on command line, e.g.
|
||||||
<tt><command></tt>make install
|
<tt><command></tt>make install
|
||||||
<tt></command></tt> produces:
|
<tt></command></tt> produces:
|
||||||
<b>make install</b>.
|
<b>make install</b>.
|
||||||
</p></li><li><p><a name="id2913353"/>
|
</p></li><li><p><a name="id2923721"/>
|
||||||
<tt><replaceable></tt> -- used for
|
<tt><replaceable></tt> -- used for
|
||||||
replaceable text, e.g.
|
replaceable text, e.g.
|
||||||
<tt><command></tt>db2html<tt><replaceable></tt>
|
<tt><command></tt>db2html<tt><replaceable></tt>
|
||||||
@ -1131,15 +1131,15 @@ url="http://www.gnome.org">GNOME Web page</ulink>
|
|||||||
is required.
|
is required.
|
||||||
</p><p>
|
</p><p>
|
||||||
here is partial list of most commonly used enitites:
|
here is partial list of most commonly used enitites:
|
||||||
</p><div class="itemizedlist"><ul><li><p><a name="id2913824"/>
|
</p><div class="itemizedlist"><ul><li><p><a name="id2924181"/>
|
||||||
<tt>&amp;</tt> -- ampersend (&)
|
<tt>&amp;</tt> -- ampersend (&)
|
||||||
</p></li><li><p><a name="id2913843"/>
|
</p></li><li><p><a name="id2924202"/>
|
||||||
<tt>&lt;</tt> -- left angle bracket (<)
|
<tt>&lt;</tt> -- left angle bracket (<)
|
||||||
</p></li><li><p><a name="id2913862"/>
|
</p></li><li><p><a name="id2924221"/>
|
||||||
<tt>&copy;</tt> -- copyright sign (<28>)
|
<tt>&copy;</tt> -- copyright sign (<28>)
|
||||||
</p></li><li><p><a name="id2913880"/>
|
</p></li><li><p><a name="id2924239"/>
|
||||||
<tt>&mdash;</tt> -- long dash (--)
|
<tt>&mdash;</tt> -- long dash (--)
|
||||||
</p></li><li><p><a name="id2913902"/>
|
</p></li><li><p><a name="id2924265"/>
|
||||||
<tt>&hellip;</tt> -- ellipsis (...)
|
<tt>&hellip;</tt> -- ellipsis (...)
|
||||||
</p></li></ul></div><p>
|
</p></li></ul></div><p>
|
||||||
Note that the actual look of the resulting symbols depends
|
Note that the actual look of the resulting symbols depends
|
||||||
@ -1194,7 +1194,7 @@ url="http://www.gnome.org">GNOME Web page</ulink>
|
|||||||
each window or panel presented to the user using screenshots (in
|
each window or panel presented to the user using screenshots (in
|
||||||
PNG format only) when appropriate. They should also describe
|
PNG format only) when appropriate. They should also describe
|
||||||
each feature and preference option available.
|
each feature and preference option available.
|
||||||
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2914346"/>Documentation Availability</h3><p>
|
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2924708"/>Documentation Availability</h3><p>
|
||||||
Applications and applets should not rely on documentation
|
Applications and applets should not rely on documentation
|
||||||
which is only available on the internet. All manuals and
|
which is only available on the internet. All manuals and
|
||||||
other documentation should be packaged with the application or
|
other documentation should be packaged with the application or
|
||||||
@ -1205,14 +1205,14 @@ url="http://www.gnome.org">GNOME Web page</ulink>
|
|||||||
the templates in <a href="#template2-1x" title="Template 2: Applet Manual For GNOME 1.x">the section called “Template 2: Applet Manual For GNOME 1.x”</a> for GNOME
|
the templates in <a href="#template2-1x" title="Template 2: Applet Manual For GNOME 1.x">the section called “Template 2: Applet Manual For GNOME 1.x”</a> for GNOME
|
||||||
versions 1.x and the templates in <a href="#template2-2x" title="Template 2: Applet Manual For GNOME 2.x">the section called “Template 2: Applet Manual For GNOME 2.x”</a>
|
versions 1.x and the templates in <a href="#template2-2x" title="Template 2: Applet Manual For GNOME 2.x">the section called “Template 2: Applet Manual For GNOME 2.x”</a>
|
||||||
for GNOME versions 2.x.
|
for GNOME versions 2.x.
|
||||||
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2914439"/>Manuals For Large Applications</h3><p>
|
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2924802"/>Manuals For Large Applications</h3><p>
|
||||||
Manuals for very large applications, such as GNOME Workshop
|
Manuals for very large applications, such as GNOME Workshop
|
||||||
components should be a <tt><book></tt> (and thus
|
components should be a <tt><book></tt> (and thus
|
||||||
use <tt><chapter></tt> for each primary section)
|
use <tt><chapter></tt> for each primary section)
|
||||||
, instead of <tt><article></tt> which most
|
, instead of <tt><article></tt> which most
|
||||||
applications use(with each primary section being a
|
applications use(with each primary section being a
|
||||||
<tt><sect1></tt>).
|
<tt><sect1></tt>).
|
||||||
</p></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2914497"/>Applet Manuals in GNOME 2.0</h3><p>
|
</p></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2924860"/>Applet Manuals in GNOME 2.0</h3><p>
|
||||||
Note that applet manuals in GNOME 2.0 are treated in a special
|
Note that applet manuals in GNOME 2.0 are treated in a special
|
||||||
way. The manuals for all applets are merged into a single
|
way. The manuals for all applets are merged into a single
|
||||||
virtual document by Nautilus. For this reason, the header
|
virtual document by Nautilus. For this reason, the header
|
||||||
@ -1228,7 +1228,7 @@ url="http://www.gnome.org">GNOME Web page</ulink>
|
|||||||
application, as described in <a href="#listingdocsinhelpmenu" title="Listing Documents in the Help Menu">the section called “Listing Documents in the Help Menu”</a>.
|
application, as described in <a href="#listingdocsinhelpmenu" title="Listing Documents in the Help Menu">the section called “Listing Documents in the Help Menu”</a>.
|
||||||
Applets should make their manuals available by
|
Applets should make their manuals available by
|
||||||
right-clicking on the applet.
|
right-clicking on the applet.
|
||||||
</p></div><div class="sect1"><a name="listingdocsinhelpmenu"/><div class="titlepage"><div><h2 class="title" style="clear: both"><a name="listingdocsinhelpmenu"/>Listing Documents in the Help Menu</h2></div></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2914617"/>Developer Information</h3><p>
|
</p></div><div class="sect1"><a name="listingdocsinhelpmenu"/><div class="titlepage"><div><h2 class="title" style="clear: both"><a name="listingdocsinhelpmenu"/>Listing Documents in the Help Menu</h2></div></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2924983"/>Developer Information</h3><p>
|
||||||
This section is for developers. Documentation authors
|
This section is for developers. Documentation authors
|
||||||
generally do not need to know this material.
|
generally do not need to know this material.
|
||||||
</p></div><p>
|
</p></div><p>
|
||||||
@ -1260,7 +1260,7 @@ function-reference.html Gnumeric function reference
|
|||||||
application's name. The application documentation (converted
|
application's name. The application documentation (converted
|
||||||
from SGML into HTML with <b>db2html</b>) should be
|
from SGML into HTML with <b>db2html</b>) should be
|
||||||
placed in this directory too.
|
placed in this directory too.
|
||||||
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2914806"/>Note</h3><p>
|
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2925171"/>Note</h3><p>
|
||||||
If the help files are not present in the correct directory, the
|
If the help files are not present in the correct directory, the
|
||||||
menu items will NOT appear when the program is run.
|
menu items will NOT appear when the program is run.
|
||||||
</p></div><p>
|
</p></div><p>
|
||||||
@ -1286,7 +1286,7 @@ GnomeUIInfo helpmenu[] = {
|
|||||||
Help menu. When the user selects any of these
|
Help menu. When the user selects any of these
|
||||||
topics from the Help menu, a help browser
|
topics from the Help menu, a help browser
|
||||||
will be started with the associated HTML documentation.
|
will be started with the associated HTML documentation.
|
||||||
</p></div><div class="sect1"><a name="applicationhelpbuttons"/><div class="titlepage"><div><h2 class="title" style="clear: both"><a name="applicationhelpbuttons"/>Application Help Buttons</h2></div></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2914972"/>Developer Information</h3><p>
|
</p></div><div class="sect1"><a name="applicationhelpbuttons"/><div class="titlepage"><div><h2 class="title" style="clear: both"><a name="applicationhelpbuttons"/>Application Help Buttons</h2></div></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2925335"/>Developer Information</h3><p>
|
||||||
This section is for developers. Documentation authors
|
This section is for developers. Documentation authors
|
||||||
generally do not need to know this material.
|
generally do not need to know this material.
|
||||||
</p></div><p>
|
</p></div><p>
|
||||||
@ -1311,7 +1311,7 @@ if (tmp) {
|
|||||||
gnome_help_goto(0, tmp);
|
gnome_help_goto(0, tmp);
|
||||||
g_free(tmp);
|
g_free(tmp);
|
||||||
}
|
}
|
||||||
</pre><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2915108"/>NOTE</h3><p>
|
</pre><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2925473"/>NOTE</h3><p>
|
||||||
The example above is in the C language, please refer to other
|
The example above is in the C language, please refer to other
|
||||||
documentation or forums for other GNOME language bindings.
|
documentation or forums for other GNOME language bindings.
|
||||||
</p></div></div><div class="sect1"><a name="packagingappletdocs"/><div class="titlepage"><div><h2 class="title" style="clear: both"><a name="packagingappletdocs"/>Packaging Applet Documentation</h2></div></div><div class="sect2"><a name="appletfiles"/><div class="titlepage"><div><h3 class="title"><a name="appletfiles"/>Applet Documentation Files</h3></div></div><p>
|
</p></div></div><div class="sect1"><a name="packagingappletdocs"/><div class="titlepage"><div><h2 class="title" style="clear: both"><a name="packagingappletdocs"/>Packaging Applet Documentation</h2></div></div><div class="sect2"><a name="appletfiles"/><div class="titlepage"><div><h3 class="title"><a name="appletfiles"/>Applet Documentation Files</h3></div></div><p>
|
||||||
@ -1348,7 +1348,7 @@ if (tmp) {
|
|||||||
of the <i>GNOME Applets</i> book, you must
|
of the <i>GNOME Applets</i> book, you must
|
||||||
remember to add <tt><legalnotice></tt> and
|
remember to add <tt><legalnotice></tt> and
|
||||||
<tt><copyright></tt> sections.
|
<tt><copyright></tt> sections.
|
||||||
</p></div><div class="sect2"><a name="appletmenu"/><div class="titlepage"><div><h3 class="title"><a name="appletmenu"/>Adding Documentation to an Applet Menu</h3></div></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2915355"/>Developer Information</h3><p>
|
</p></div><div class="sect2"><a name="appletmenu"/><div class="titlepage"><div><h3 class="title"><a name="appletmenu"/>Adding Documentation to an Applet Menu</h3></div></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2925721"/>Developer Information</h3><p>
|
||||||
This section is for developers. Documentation authors
|
This section is for developers. Documentation authors
|
||||||
generally do not need to know this material.
|
generally do not need to know this material.
|
||||||
</p></div><p>
|
</p></div><p>
|
||||||
@ -1453,7 +1453,7 @@ applet_widget_register_stock_callback (APPLET_WIDGET(applet), "about",
|
|||||||
</p></div><div class="sect2"><a name="balance"/><div class="titlepage"><div><h3 class="title"><a name="balance"/>Achieving a Balanced Style</h3></div></div><p>
|
</p></div><div class="sect2"><a name="balance"/><div class="titlepage"><div><h3 class="title"><a name="balance"/>Achieving a Balanced Style</h3></div></div><p>
|
||||||
Just as you need to juggle expert and novice readers,
|
Just as you need to juggle expert and novice readers,
|
||||||
you'll have to juggle a number of other extremes as you write:
|
you'll have to juggle a number of other extremes as you write:
|
||||||
<div class="itemizedlist"><ul><li><p><a name="id2915900"/>
|
<div class="itemizedlist"><ul><li><p><a name="id2926279"/>
|
||||||
Documents should be complete, yet concise. You should
|
Documents should be complete, yet concise. You should
|
||||||
describe every feature, but you'll have decide how much
|
describe every feature, but you'll have decide how much
|
||||||
detail is really necessary. It's not, for example,
|
detail is really necessary. It's not, for example,
|
||||||
@ -1463,7 +1463,7 @@ applet_widget_register_stock_callback (APPLET_WIDGET(applet), "about",
|
|||||||
you spend fewer words on the obvious, you can spend more
|
you spend fewer words on the obvious, you can spend more
|
||||||
time clarifying the ambiguous labels and explaining
|
time clarifying the ambiguous labels and explaining
|
||||||
items that are more complex.
|
items that are more complex.
|
||||||
</p></li><li><p><a name="id2915927"/>
|
</p></li><li><p><a name="id2926306"/>
|
||||||
Be engaging and friendly, yet professional. Games
|
Be engaging and friendly, yet professional. Games
|
||||||
documents may be less formal than productivity
|
documents may be less formal than productivity
|
||||||
application documents (people don't
|
application documents (people don't
|
||||||
@ -1472,14 +1472,14 @@ applet_widget_register_stock_callback (APPLET_WIDGET(applet), "about",
|
|||||||
maintain a standard of style which holds the reader's
|
maintain a standard of style which holds the reader's
|
||||||
interest without resorting to jokes and untranslatable
|
interest without resorting to jokes and untranslatable
|
||||||
allusions or puns.
|
allusions or puns.
|
||||||
</p></li><li><p><a name="id2915966"/>
|
</p></li><li><p><a name="id2926345"/>
|
||||||
Examples, tips, notes, and screenshots are useful to
|
Examples, tips, notes, and screenshots are useful to
|
||||||
break up long stretches of text, but too many can get in
|
break up long stretches of text, but too many can get in
|
||||||
the way, and make your documents too choppy to read.
|
the way, and make your documents too choppy to read.
|
||||||
It's good to provide a screenshot of any dialog windows
|
It's good to provide a screenshot of any dialog windows
|
||||||
a user might run into, but if a dialog box has several
|
a user might run into, but if a dialog box has several
|
||||||
tabs, it's not usually necessary to have one for each.
|
tabs, it's not usually necessary to have one for each.
|
||||||
</p></li><li><p><a name="id2915990"/>
|
</p></li><li><p><a name="id2926368"/>
|
||||||
The GDP strives to have all of its documentation conform
|
The GDP strives to have all of its documentation conform
|
||||||
to certain standards of style and content, but every
|
to certain standards of style and content, but every
|
||||||
document (and every writer) is different. You will need
|
document (and every writer) is different. You will need
|
||||||
|
|||||||
@ -6,11 +6,11 @@
|
|||||||
<pre class="programlisting">
|
<pre class="programlisting">
|
||||||
|
|
||||||
|
|
||||||
<!DOCTYPE Article PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[
|
<!DOCTYPE Article PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[
|
||||||
<!-- if not using PNG graphic, replace reference above with
|
<!-- if not using PNG graphic, replace reference above with
|
||||||
.....PUBLIC "-//OASIS//DTD DocBook V3.1//EN"[
|
.....PUBLIC "-//OASIS//DTD DocBook V3.1//EN"[
|
||||||
-->
|
-->
|
||||||
<!ENTITY version "1.0.53">
|
<!ENTITY version "1.0.53">
|
||||||
<!-- replace version above with actual application version number-->
|
<!-- replace version above with actual application version number-->
|
||||||
<!-- Template Version: 1.0.1 (do not remove this line) -->
|
<!-- Template Version: 1.0.1 (do not remove this line) -->
|
||||||
]>
|
]>
|
||||||
@ -20,7 +20,7 @@
|
|||||||
Documentation Project Team. Please use it for writing GNOME
|
Documentation Project Team. Please use it for writing GNOME
|
||||||
documentation, making obvious changes. In particular, all the words
|
documentation, making obvious changes. In particular, all the words
|
||||||
written in UPPERCASE (with the exception of GNOME) should be
|
written in UPPERCASE (with the exception of GNOME) should be
|
||||||
replaced. As for "legalnotice", please leave the reference
|
replaced. As for "legalnotice", please leave the reference
|
||||||
unchanged.
|
unchanged.
|
||||||
|
|
||||||
Remember that this is a guide, rather than a perfect model to follow
|
Remember that this is a guide, rather than a perfect model to follow
|
||||||
@ -30,7 +30,7 @@
|
|||||||
|
|
||||||
<!-- =============Document Header ============================= -->
|
<!-- =============Document Header ============================= -->
|
||||||
|
|
||||||
<article id="index"> <!-- please do not change the id -->
|
<article id="index"> <!-- please do not change the id -->
|
||||||
|
|
||||||
<artheader>
|
<artheader>
|
||||||
<title>MY-GNOME-APP</title>
|
<title>MY-GNOME-APP</title>
|
||||||
@ -49,7 +49,7 @@
|
|||||||
-->
|
-->
|
||||||
|
|
||||||
<!-- do not put authorname in the header except in copyright - use
|
<!-- do not put authorname in the header except in copyright - use
|
||||||
section "authors" below -->
|
section "authors" below -->
|
||||||
|
|
||||||
<legalnotice>
|
<legalnotice>
|
||||||
<para>
|
<para>
|
||||||
@ -60,8 +60,8 @@
|
|||||||
Invariant Sections, no Front-Cover Texts, and no Back-Cover
|
Invariant Sections, no Front-Cover Texts, and no Back-Cover
|
||||||
Texts. You may obtain a copy of the <citetitle>GNU Free
|
Texts. You may obtain a copy of the <citetitle>GNU Free
|
||||||
Documentation License</citetitle> from the Free Software
|
Documentation License</citetitle> from the Free Software
|
||||||
Foundation by visiting <ulink type="http"
|
Foundation by visiting <ulink type="http"
|
||||||
url="http://www.fsf.org">their Web site</ulink> or by writing
|
url="http://www.fsf.org">their Web site</ulink> or by writing
|
||||||
to: Free Software Foundation, Inc., 59 Temple Place - Suite
|
to: Free Software Foundation, Inc., 59 Temple Place - Suite
|
||||||
330, Boston, MA 02111-1307, USA.
|
330, Boston, MA 02111-1307, USA.
|
||||||
</para>
|
</para>
|
||||||
@ -84,7 +84,7 @@
|
|||||||
<!-- ============= Document Body ============================= -->
|
<!-- ============= Document Body ============================= -->
|
||||||
|
|
||||||
<!-- ============= Introduction ============================== -->
|
<!-- ============= Introduction ============================== -->
|
||||||
<sect1 id="intro">
|
<sect1 id="intro">
|
||||||
<title>Introduction</title>
|
<title>Introduction</title>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
@ -125,7 +125,7 @@
|
|||||||
<!-- ================ Usage ================================ -->
|
<!-- ================ Usage ================================ -->
|
||||||
<!-- This section should describe basic usage of the application. -->
|
<!-- This section should describe basic usage of the application. -->
|
||||||
|
|
||||||
<sect1 id="usage">
|
<sect1 id="usage">
|
||||||
<title>Using MY-GNOME-APP</title>
|
<title>Using MY-GNOME-APP</title>
|
||||||
<para>
|
<para>
|
||||||
<application>MY-GNOME-APP</application> can be used to produce a
|
<application>MY-GNOME-APP</application> can be used to produce a
|
||||||
@ -137,19 +137,19 @@
|
|||||||
</para>
|
</para>
|
||||||
|
|
||||||
<!-- ========= Basic Usage =========================== -->
|
<!-- ========= Basic Usage =========================== -->
|
||||||
<sect2 id="mainwin">
|
<sect2 id="mainwin">
|
||||||
<title>Basic usage</title>
|
<title>Basic usage</title>
|
||||||
<para>
|
<para>
|
||||||
Starting <application>MY-GNOME-APP</application> opens the
|
Starting <application>MY-GNOME-APP</application> opens the
|
||||||
<interface>Main window</interface>, shown in <xref
|
<interface>Main window</interface>, shown in <xref
|
||||||
linkend="mainwindow-fig">. The window is at first empty.
|
linkend="mainwindow-fig">. The window is at first empty.
|
||||||
|
|
||||||
<!-- ==== Figure ==== -->
|
<!-- ==== Figure ==== -->
|
||||||
<figure id="mainwindow-fig">
|
<figure id="mainwindow-fig">
|
||||||
<title>MY-GNOME-APP Main Window</title>
|
<title>MY-GNOME-APP Main Window</title>
|
||||||
<screenshot>
|
<screenshot>
|
||||||
<screeninfo>MY-GNOME-APP Main Window</screeninfo>
|
<screeninfo>MY-GNOME-APP Main Window</screeninfo>
|
||||||
<graphic fileref="SCREENSHOT" format="png" srccredit="ME">
|
<graphic fileref="SCREENSHOT" format="png" srccredit="ME">
|
||||||
</graphic>
|
</graphic>
|
||||||
</screenshot>
|
</screenshot>
|
||||||
</figure>
|
</figure>
|
||||||
@ -157,13 +157,13 @@
|
|||||||
</para>
|
</para>
|
||||||
|
|
||||||
|
|
||||||
<!-- For this app, one could put "proving" or "edit" (probably even
|
<!-- For this app, one could put "proving" or "edit" (probably even
|
||||||
both of them) as sect2's seperate from the main window
|
both of them) as sect2's seperate from the main window
|
||||||
section. Since they were both so closely involved with the main
|
section. Since they were both so closely involved with the main
|
||||||
window, I decided to have them as sect3's isntead. Judgement
|
window, I decided to have them as sect3's isntead. Judgement
|
||||||
call. -->
|
call. -->
|
||||||
|
|
||||||
<sect3 id="proving">
|
<sect3 id="proving">
|
||||||
<title>Proving a Theorem</title>
|
<title>Proving a Theorem</title>
|
||||||
<para>
|
<para>
|
||||||
To get a proof of a theorem, select
|
To get a proof of a theorem, select
|
||||||
@ -242,7 +242,7 @@
|
|||||||
</para>
|
</para>
|
||||||
</warning>
|
</warning>
|
||||||
</sect3>
|
</sect3>
|
||||||
<sect3 id="editing">
|
<sect3 id="editing">
|
||||||
<title>Editing Proofs</title>
|
<title>Editing Proofs</title>
|
||||||
<para>
|
<para>
|
||||||
Once you have proven the theorem, it will be displayed in
|
Once you have proven the theorem, it will be displayed in
|
||||||
@ -295,16 +295,16 @@
|
|||||||
============================================================= -->
|
============================================================= -->
|
||||||
|
|
||||||
|
|
||||||
<sect2 id="toolbar">
|
<sect2 id="toolbar">
|
||||||
<title>Toolbar</title>
|
<title>Toolbar</title>
|
||||||
<para>
|
<para>
|
||||||
The toolbar (shown in <xref linkend="figure-usage-toolbar">)
|
The toolbar (shown in <xref linkend="figure-usage-toolbar">)
|
||||||
provides access to several commonly used routines.
|
provides access to several commonly used routines.
|
||||||
<figure id="figure-usage-toolbar">
|
<figure id="figure-usage-toolbar">
|
||||||
<title>MY-GNOME-APP Toolbar</title>
|
<title>MY-GNOME-APP Toolbar</title>
|
||||||
<screenshot>
|
<screenshot>
|
||||||
<screeninfo>MY-GNOME-APP Toolbar</screeninfo>
|
<screeninfo>MY-GNOME-APP Toolbar</screeninfo>
|
||||||
<graphic fileref="usage-toolbar.png" format="png"></graphic>
|
<graphic fileref="usage-toolbar.png" format="png"></graphic>
|
||||||
</screenshot>
|
</screenshot>
|
||||||
</figure>
|
</figure>
|
||||||
<variablelist>
|
<variablelist>
|
||||||
@ -340,7 +340,7 @@
|
|||||||
</sect2>
|
</sect2>
|
||||||
<!-- ========= Menus =========================== -->
|
<!-- ========= Menus =========================== -->
|
||||||
|
|
||||||
<sect2 id="menubar">
|
<sect2 id="menubar">
|
||||||
|
|
||||||
<!-- Describing the menubar ensures comprehensive feature
|
<!-- Describing the menubar ensures comprehensive feature
|
||||||
coverage. Nest itemizedlists inside variablelists so that each
|
coverage. Nest itemizedlists inside variablelists so that each
|
||||||
@ -479,7 +479,7 @@
|
|||||||
<para>
|
<para>
|
||||||
<guimenuitem>Preferences&hellip;</guimenuitem>
|
<guimenuitem>Preferences&hellip;</guimenuitem>
|
||||||
&mdash; This opens the <link
|
&mdash; This opens the <link
|
||||||
linkend="prefs"><interface>Preferences
|
linkend="prefs"><interface>Preferences
|
||||||
Dialog</interface></link>, which allows you to configure
|
Dialog</interface></link>, which allows you to configure
|
||||||
many settings.
|
many settings.
|
||||||
</para>
|
</para>
|
||||||
@ -532,7 +532,7 @@
|
|||||||
|
|
||||||
<!-- ============= Customization ============================= -->
|
<!-- ============= Customization ============================= -->
|
||||||
|
|
||||||
<sect1 id="prefs">
|
<sect1 id="prefs">
|
||||||
<title>Customization</title>
|
<title>Customization</title>
|
||||||
<para>
|
<para>
|
||||||
To change the application settings, select
|
To change the application settings, select
|
||||||
@ -541,15 +541,15 @@
|
|||||||
<guimenuitem>Preferences...</guimenuitem>
|
<guimenuitem>Preferences...</guimenuitem>
|
||||||
</menuchoice>. This opens the
|
</menuchoice>. This opens the
|
||||||
<interface>Preferences</interface> dialog, shown in <xref
|
<interface>Preferences</interface> dialog, shown in <xref
|
||||||
linkend="preferences-fig">.
|
linkend="preferences-fig">.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<figure id="preferences-fig">
|
<figure id="preferences-fig">
|
||||||
<title>Preferences Dialog</title>
|
<title>Preferences Dialog</title>
|
||||||
<screenshot>
|
<screenshot>
|
||||||
<screeninfo>Preferences Dialog</screeninfo>
|
<screeninfo>Preferences Dialog</screeninfo>
|
||||||
<graphic fileref="SCREENSHOT" format="png"
|
<graphic fileref="SCREENSHOT" format="png"
|
||||||
srccredit="ME">
|
srccredit="ME">
|
||||||
</graphic>
|
</graphic>
|
||||||
</screenshot>
|
</screenshot>
|
||||||
</figure>
|
</figure>
|
||||||
@ -635,7 +635,7 @@
|
|||||||
<!-- This section should describe known bugs and limitations of
|
<!-- This section should describe known bugs and limitations of
|
||||||
the program if there are any - please be frank and list all
|
the program if there are any - please be frank and list all
|
||||||
problems you know of. -->
|
problems you know of. -->
|
||||||
<sect1 id="bugs">
|
<sect1 id="bugs">
|
||||||
<title>Known Bugs and Limitations</title>
|
<title>Known Bugs and Limitations</title>
|
||||||
<para>
|
<para>
|
||||||
This application has no known bugs.
|
This application has no known bugs.
|
||||||
@ -645,18 +645,18 @@
|
|||||||
|
|
||||||
<!-- ============= Authors ================================ -->
|
<!-- ============= Authors ================================ -->
|
||||||
|
|
||||||
<sect1 id="authors">
|
<sect1 id="authors">
|
||||||
<title>Authors</title>
|
<title>Authors</title>
|
||||||
<para>
|
<para>
|
||||||
<application>MY-GNOME-APP</application> was written by GNOME-HACKER
|
<application>MY-GNOME-APP</application> was written by GNOME-HACKER
|
||||||
(<email>hacker@gnome.org</email>). To find more information about
|
(<email>hacker@gnome.org</email>). To find more information about
|
||||||
<application>MY-GNOME-APP</application>, please visit the <ulink
|
<application>MY-GNOME-APP</application>, please visit the <ulink
|
||||||
url="http://www.my-gnome-app.org" type="http">MY-GNOME-APP Web
|
url="http://www.my-gnome-app.org" type="http">MY-GNOME-APP Web
|
||||||
page</ulink>. Please send all comments, suggestions, and bug
|
page</ulink>. Please send all comments, suggestions, and bug
|
||||||
reports to the <ulink url="http://bugs.gnome.org" type="http">GNOME
|
reports to the <ulink url="http://bugs.gnome.org" type="http">GNOME
|
||||||
bug tracking database</ulink>. (Instructions for submitting bug
|
bug tracking database</ulink>. (Instructions for submitting bug
|
||||||
reports can be found <ulink
|
reports can be found <ulink
|
||||||
url="http://bugs.gnome.org/Reporting.html" type="http">
|
url="http://bugs.gnome.org/Reporting.html" type="http">
|
||||||
on-line</ulink>.) You can also use <application>Bug Report
|
on-line</ulink>.) You can also use <application>Bug Report
|
||||||
Tool</application> (<command>bug-buddy</command>), available in the
|
Tool</application> (<command>bug-buddy</command>), available in the
|
||||||
<guisubmenu>Utilities</guisubmenu> submenu of <guimenu>Main
|
<guisubmenu>Utilities</guisubmenu> submenu of <guimenu>Main
|
||||||
@ -666,12 +666,12 @@
|
|||||||
<para>
|
<para>
|
||||||
This manual was written by ME
|
This manual was written by ME
|
||||||
(<email>MYNAME@MYADDRESS</email>). Please send all comments and
|
(<email>MYNAME@MYADDRESS</email>). Please send all comments and
|
||||||
suggestions regarding this manual to the <ulink type="http"
|
suggestions regarding this manual to the <ulink type="http"
|
||||||
url="http://developer.gnome.org/projects/gdp">GNOME Documentation
|
url="http://developer.gnome.org/projects/gdp">GNOME Documentation
|
||||||
Project</ulink> by sending an email to
|
Project</ulink> by sending an email to
|
||||||
<email>docs@gnome.org</email>. You can also add your comments online
|
<email>docs@gnome.org</email>. You can also add your comments online
|
||||||
by using the <ulink type="http"
|
by using the <ulink type="http"
|
||||||
url="http://www.gnome.org/gdp/doctable/">GNOME Documentation Status
|
url="http://www.gnome.org/gdp/doctable/">GNOME Documentation Status
|
||||||
Table</ulink>.
|
Table</ulink>.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
@ -690,7 +690,7 @@
|
|||||||
|
|
||||||
<!-- ============= Application License ============================= -->
|
<!-- ============= Application License ============================= -->
|
||||||
|
|
||||||
<sect1 id="license">
|
<sect1 id="license">
|
||||||
<title>License</title>
|
<title>License</title>
|
||||||
<para>
|
<para>
|
||||||
This program is free software; you can redistribute it and/or
|
This program is free software; you can redistribute it and/or
|
||||||
@ -710,8 +710,8 @@
|
|||||||
included as an appendix to the <citetitle>GNOME Users
|
included as an appendix to the <citetitle>GNOME Users
|
||||||
Guide</citetitle>. You may also obtain a copy of the
|
Guide</citetitle>. You may also obtain a copy of the
|
||||||
<citetitle>GNU General Public License</citetitle> from the Free
|
<citetitle>GNU General Public License</citetitle> from the Free
|
||||||
Software Foundation by visiting <ulink type="http"
|
Software Foundation by visiting <ulink type="http"
|
||||||
url="http://www.fsf.org">their Web site</ulink> or by writing to
|
url="http://www.fsf.org">their Web site</ulink> or by writing to
|
||||||
<address>
|
<address>
|
||||||
Free Software Foundation, Inc.
|
Free Software Foundation, Inc.
|
||||||
<street>59 Temple Place</street> - Suite 330
|
<street>59 Temple Place</street> - Suite 330
|
||||||
|
|||||||
@ -14,8 +14,8 @@
|
|||||||
<pre class="programlisting">
|
<pre class="programlisting">
|
||||||
|
|
||||||
|
|
||||||
<!DOCTYPE Article PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[
|
<!DOCTYPE Article PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[
|
||||||
<!entity APPLETNAME.sgml SYSTEM "applet_template_1.sgml">
|
<!entity APPLETNAME.sgml SYSTEM "applet_template_1.sgml">
|
||||||
<!-- Template Version: 1.0.1 (do not remove this line) -->
|
<!-- Template Version: 1.0.1 (do not remove this line) -->
|
||||||
]>
|
]>
|
||||||
|
|
||||||
@ -23,7 +23,7 @@
|
|||||||
Documentation Project Team. Please use it for writing GNOME
|
Documentation Project Team. Please use it for writing GNOME
|
||||||
documentation, making obvious changes. In particular, all the words
|
documentation, making obvious changes. In particular, all the words
|
||||||
written in UPPERCASE (with the exception of GNOME) should be
|
written in UPPERCASE (with the exception of GNOME) should be
|
||||||
replaced. As for "legalnotice", please leave the reference
|
replaced. As for "legalnotice", please leave the reference
|
||||||
unchanged,make sure to add/remove trademarks to the list as
|
unchanged,make sure to add/remove trademarks to the list as
|
||||||
appropriate for your document.
|
appropriate for your document.
|
||||||
|
|
||||||
@ -31,7 +31,7 @@
|
|||||||
thanks ;-).
|
thanks ;-).
|
||||||
-->
|
-->
|
||||||
|
|
||||||
<article id="index"> <!-- please do not change the id -->
|
<article id="index"> <!-- please do not change the id -->
|
||||||
|
|
||||||
<!-- ============= Document Header ============================= -->
|
<!-- ============= Document Header ============================= -->
|
||||||
<artheader>
|
<artheader>
|
||||||
@ -51,7 +51,7 @@
|
|||||||
-->
|
-->
|
||||||
|
|
||||||
<!-- do not put authorname in the header except in copyright - use
|
<!-- do not put authorname in the header except in copyright - use
|
||||||
section "authors" below -->
|
section "authors" below -->
|
||||||
|
|
||||||
<legalnotice>
|
<legalnotice>
|
||||||
<para>
|
<para>
|
||||||
@ -61,8 +61,8 @@
|
|||||||
by the Free Software Foundation with no Invariant Sections, no
|
by the Free Software Foundation with no Invariant Sections, no
|
||||||
Front-Cover Texts, and no Back-Cover Texts. You may obtain a copy
|
Front-Cover Texts, and no Back-Cover Texts. You may obtain a copy
|
||||||
of the <citetitle>GNU Free Documentation License</citetitle> from
|
of the <citetitle>GNU Free Documentation License</citetitle> from
|
||||||
the Free Software Foundation by visiting <ulink type="http"
|
the Free Software Foundation by visiting <ulink type="http"
|
||||||
url="http://www.fsf.org">their Web site</ulink> or by writing to:
|
url="http://www.fsf.org">their Web site</ulink> or by writing to:
|
||||||
Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
||||||
Boston, MA 02111-1307, USA.
|
Boston, MA 02111-1307, USA.
|
||||||
</para>
|
</para>
|
||||||
@ -95,12 +95,12 @@
|
|||||||
|
|
||||||
<!-- Template Version: 1.0.1 (do not remove this line) -->
|
<!-- Template Version: 1.0.1 (do not remove this line) -->
|
||||||
|
|
||||||
<sect1 id="APPLET">
|
<sect1 id="APPLET">
|
||||||
<title>APPLET Applet</title>
|
<title>APPLET Applet</title>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
<application>APPLET</application> applet, shown in <xref
|
<application>APPLET</application> applet, shown in <xref
|
||||||
linkend="APPLETapplet-fig">, allows you to &hellip;. To add this
|
linkend="APPLETapplet-fig">, allows you to &hellip;. To add this
|
||||||
applet to a <interface>Panel</interface>,
|
applet to a <interface>Panel</interface>,
|
||||||
right-click on the <interface>Panel</interface> and choose
|
right-click on the <interface>Panel</interface> and choose
|
||||||
<menuchoice>
|
<menuchoice>
|
||||||
@ -112,18 +112,18 @@
|
|||||||
</menuchoice>.
|
</menuchoice>.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<figure id="APPLETapplet-fig">
|
<figure id="APPLETapplet-fig">
|
||||||
<title>APPLET Applet</title>
|
<title>APPLET Applet</title>
|
||||||
<screenshot>
|
<screenshot>
|
||||||
<screeninfo>APPLET Applet</screeninfo>
|
<screeninfo>APPLET Applet</screeninfo>
|
||||||
<graphic format="png" fileref="APPLET_applet"
|
<graphic format="png" fileref="APPLET_applet"
|
||||||
srccredit="YOURNAME">
|
srccredit="YOURNAME">
|
||||||
</graphic>
|
</graphic>
|
||||||
</screenshot>
|
</screenshot>
|
||||||
</figure>
|
</figure>
|
||||||
|
|
||||||
<!-- ============= Usage ================================ -->
|
<!-- ============= Usage ================================ -->
|
||||||
<sect2 id="APPLET-usage">
|
<sect2 id="APPLET-usage">
|
||||||
<title>Usage</title>
|
<title>Usage</title>
|
||||||
<para>
|
<para>
|
||||||
(Place a short description of how to use the applet here.)
|
(Place a short description of how to use the applet here.)
|
||||||
@ -137,7 +137,7 @@
|
|||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
<guimenuitem>Properties&hellip;</guimenuitem> &mdash;
|
<guimenuitem>Properties&hellip;</guimenuitem> &mdash;
|
||||||
opens the <link linkend="APPLET-prefs">
|
opens the <link linkend="APPLET-prefs">
|
||||||
<guilabel>Properties</guilabel></link> dialog.
|
<guilabel>Properties</guilabel></link> dialog.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
@ -164,23 +164,23 @@
|
|||||||
|
|
||||||
|
|
||||||
<!-- ============= Customization ============================= -->
|
<!-- ============= Customization ============================= -->
|
||||||
<sect2 id="APPLET-prefs">
|
<sect2 id="APPLET-prefs">
|
||||||
<title>Customization</title>
|
<title>Customization</title>
|
||||||
<para>
|
<para>
|
||||||
You can customize <application>APPLET</application>
|
You can customize <application>APPLET</application>
|
||||||
applet by right-clicking on it and choosing
|
applet by right-clicking on it and choosing
|
||||||
<guimenuitem>Properties&hellip;</guimenuitem>. This will open the
|
<guimenuitem>Properties&hellip;</guimenuitem>. This will open the
|
||||||
<interface>Properties</interface> dialog(shown in <xref
|
<interface>Properties</interface> dialog(shown in <xref
|
||||||
linkend="APPLET-settings-fig">), which allows you to
|
linkend="APPLET-settings-fig">), which allows you to
|
||||||
change various settings.
|
change various settings.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<figure id="APPLET-settings-fig">
|
<figure id="APPLET-settings-fig">
|
||||||
<title>Properties dialog</title>
|
<title>Properties dialog</title>
|
||||||
<screenshot>
|
<screenshot>
|
||||||
<screeninfo>Properties dialog</screeninfo>
|
<screeninfo>Properties dialog</screeninfo>
|
||||||
<graphic format="png" fileref="APPLET_settings"
|
<graphic format="png" fileref="APPLET_settings"
|
||||||
srccredit="YOURNAME">
|
srccredit="YOURNAME">
|
||||||
</graphic>
|
</graphic>
|
||||||
</screenshot>
|
</screenshot>
|
||||||
</figure>
|
</figure>
|
||||||
@ -226,7 +226,7 @@
|
|||||||
<!-- This section should describe known bugs and limitations of
|
<!-- This section should describe known bugs and limitations of
|
||||||
the program if there are any - please be frank and list all
|
the program if there are any - please be frank and list all
|
||||||
problems you know of -->
|
problems you know of -->
|
||||||
<sect2 id="bugs">
|
<sect2 id="bugs">
|
||||||
<title>Known Bugs and Limitations</title>
|
<title>Known Bugs and Limitations</title>
|
||||||
<para>
|
<para>
|
||||||
This applet has no known bugs.
|
This applet has no known bugs.
|
||||||
@ -236,16 +236,16 @@
|
|||||||
|
|
||||||
<!-- ============= Authors ================================ -->
|
<!-- ============= Authors ================================ -->
|
||||||
|
|
||||||
<sect2 id="authors">
|
<sect2 id="authors">
|
||||||
<title>Authors</title>
|
<title>Authors</title>
|
||||||
<para>
|
<para>
|
||||||
<application>APPLET</application> was written by GNOME-HACKER
|
<application>APPLET</application> was written by GNOME-HACKER
|
||||||
(<email>hacker@gnome.org</email>). Please send all comments,
|
(<email>hacker@gnome.org</email>). Please send all comments,
|
||||||
suggestions, and bug
|
suggestions, and bug
|
||||||
reports to the <ulink url="http://bugs.gnome.org" type="http">GNOME
|
reports to the <ulink url="http://bugs.gnome.org" type="http">GNOME
|
||||||
bug tracking database</ulink>. (Instructions for submitting bug
|
bug tracking database</ulink>. (Instructions for submitting bug
|
||||||
reports can be found <ulink
|
reports can be found <ulink
|
||||||
url="http://bugs.gnome.org/Reporting.html" type="http">
|
url="http://bugs.gnome.org/Reporting.html" type="http">
|
||||||
on-line</ulink>. You can also use <application>Bug Report
|
on-line</ulink>. You can also use <application>Bug Report
|
||||||
Tool</application> (<command>bug-buddy</command>), available in the
|
Tool</application> (<command>bug-buddy</command>), available in the
|
||||||
<guisubmenu>Utilities</guisubmenu> submenu of <guimenu>Main
|
<guisubmenu>Utilities</guisubmenu> submenu of <guimenu>Main
|
||||||
@ -255,12 +255,12 @@
|
|||||||
<para>
|
<para>
|
||||||
This manual was written by ME
|
This manual was written by ME
|
||||||
(<email>MYNAME@MYADDRESS</email>). Please send all comments and
|
(<email>MYNAME@MYADDRESS</email>). Please send all comments and
|
||||||
suggestions regarding this manual to the <ulink type="http"
|
suggestions regarding this manual to the <ulink type="http"
|
||||||
url="http://developer.gnome.org/projects/gdp">GNOME Documentation
|
url="http://developer.gnome.org/projects/gdp">GNOME Documentation
|
||||||
Project</ulink> by sending an email to
|
Project</ulink> by sending an email to
|
||||||
<email>docs@gnome.org</email>. You can also submit comments online
|
<email>docs@gnome.org</email>. You can also submit comments online
|
||||||
by using the <ulink type="http"
|
by using the <ulink type="http"
|
||||||
url="http://www.gnome.org/gdp/doctable/">GNOME Documentation
|
url="http://www.gnome.org/gdp/doctable/">GNOME Documentation
|
||||||
Status Table</ulink>.
|
Status Table</ulink>.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
@ -279,7 +279,7 @@
|
|||||||
|
|
||||||
<!-- ============= Application License ============================= -->
|
<!-- ============= Application License ============================= -->
|
||||||
|
|
||||||
<sect2 id="license">
|
<sect2 id="license">
|
||||||
<title>License</title>
|
<title>License</title>
|
||||||
<para>
|
<para>
|
||||||
This program is free software; you can redistribute it and/or
|
This program is free software; you can redistribute it and/or
|
||||||
@ -299,8 +299,8 @@
|
|||||||
included as an appendix to the <citetitle>GNOME Users
|
included as an appendix to the <citetitle>GNOME Users
|
||||||
Guide</citetitle>. You may also obtain a copy of the
|
Guide</citetitle>. You may also obtain a copy of the
|
||||||
<citetitle>GNU General Public License</citetitle> from the Free
|
<citetitle>GNU General Public License</citetitle> from the Free
|
||||||
Software Foundation by visiting <ulink type="http"
|
Software Foundation by visiting <ulink type="http"
|
||||||
url="http://www.fsf.org">their Web site</ulink> or by writing to
|
url="http://www.fsf.org">their Web site</ulink> or by writing to
|
||||||
<address>
|
<address>
|
||||||
Free Software Foundation, Inc.
|
Free Software Foundation, Inc.
|
||||||
<street>59 Temple Place</street> - Suite 330
|
<street>59 Temple Place</street> - Suite 330
|
||||||
|
|||||||
@ -18,12 +18,12 @@
|
|||||||
</p><p>
|
</p><p>
|
||||||
<pre class="programlisting">
|
<pre class="programlisting">
|
||||||
|
|
||||||
<!DOCTYPE book PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[
|
<!DOCTYPE book PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[
|
||||||
<!ENTITY TEMPLATE-APPLET SYSTEM "gnome-applet-template.sgml.part">
|
<!ENTITY TEMPLATE-APPLET SYSTEM "gnome-applet-template.sgml.part">
|
||||||
|
|
||||||
]>
|
]>
|
||||||
|
|
||||||
<book id="gnome-applets">
|
<book id="gnome-applets">
|
||||||
|
|
||||||
<bookinfo>
|
<bookinfo>
|
||||||
<title>GNOME Applets</title>
|
<title>GNOME Applets</title>
|
||||||
@ -72,11 +72,11 @@
|
|||||||
</bookinfo>
|
</bookinfo>
|
||||||
|
|
||||||
<!-- #### Introduction ###### -->
|
<!-- #### Introduction ###### -->
|
||||||
<chapter id="applets-intro">
|
<chapter id="applets-intro">
|
||||||
<title>Introduction</title>
|
<title>Introduction</title>
|
||||||
|
|
||||||
<!-- #### Intro | What Are Applets? ###### -->
|
<!-- #### Intro | What Are Applets? ###### -->
|
||||||
<sect1 id="applets-what-are">
|
<sect1 id="applets-what-are">
|
||||||
<title>What Are Applets?</title>
|
<title>What Are Applets?</title>
|
||||||
<para>
|
<para>
|
||||||
Applets are one of the most popular and useful objects you can add
|
Applets are one of the most popular and useful objects you can add
|
||||||
@ -108,17 +108,17 @@
|
|||||||
</para>
|
</para>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
<figure id="example-applets-fig">
|
<figure id="example-applets-fig">
|
||||||
<title>Example Applets</title>
|
<title>Example Applets</title>
|
||||||
<screenshot>
|
<screenshot>
|
||||||
<screeninfo>Example Applets</screeninfo>
|
<screeninfo>Example Applets</screeninfo>
|
||||||
<graphic fileref="example_applets" format="png"
|
<graphic fileref="example_applets" format="png"
|
||||||
srccredit="muet">
|
srccredit="muet">
|
||||||
</graphic>
|
</graphic>
|
||||||
</screenshot>
|
</screenshot>
|
||||||
</figure>
|
</figure>
|
||||||
Several example applets are shown in <xref
|
Several example applets are shown in <xref
|
||||||
linkend="example-applets-fig">. From left to right, they are: (1)
|
linkend="example-applets-fig">. From left to right, they are: (1)
|
||||||
<application>Mixer Applet</application>, which allows you to turn
|
<application>Mixer Applet</application>, which allows you to turn
|
||||||
on/off sound and control its volume by clicking on the applet. (2)
|
on/off sound and control its volume by clicking on the applet. (2)
|
||||||
<application>Sound Monitor</application> Applet, which displays
|
<application>Sound Monitor</application> Applet, which displays
|
||||||
@ -140,8 +140,8 @@
|
|||||||
<interface>Panels</interface> and using them. The following
|
<interface>Panels</interface> and using them. The following
|
||||||
chapters go through each of the standard GNOME applets describing
|
chapters go through each of the standard GNOME applets describing
|
||||||
them in detail. There are also additional applets which can be
|
them in detail. There are also additional applets which can be
|
||||||
downloaded off the Web. See <ulink type="http"
|
downloaded off the Web. See <ulink type="http"
|
||||||
url="http://www.gnome.org/applist/list-martin.phtml">The GNOME
|
url="http://www.gnome.org/applist/list-martin.phtml">The GNOME
|
||||||
Software Map</ulink> for lists of additional GNOME applications
|
Software Map</ulink> for lists of additional GNOME applications
|
||||||
and applets.
|
and applets.
|
||||||
</para>
|
</para>
|
||||||
@ -153,10 +153,10 @@
|
|||||||
</sect1>
|
</sect1>
|
||||||
|
|
||||||
<!-- #### Intro | Adding, Moving, and Removing Applets ###### -->
|
<!-- #### Intro | Adding, Moving, and Removing Applets ###### -->
|
||||||
<sect1 id="applet-add-move-replace">
|
<sect1 id="applet-add-move-replace">
|
||||||
<title>Adding, Moving, and Removing Applets</title>
|
<title>Adding, Moving, and Removing Applets</title>
|
||||||
|
|
||||||
<sect2 id="adding-applets">
|
<sect2 id="adding-applets">
|
||||||
<title>Adding Applets to a Panel</title>
|
<title>Adding Applets to a Panel</title>
|
||||||
<para>
|
<para>
|
||||||
To add an applet to a <interface>Panel</interface>, right-click
|
To add an applet to a <interface>Panel</interface>, right-click
|
||||||
@ -169,7 +169,7 @@
|
|||||||
</para>
|
</para>
|
||||||
</sect2>
|
</sect2>
|
||||||
|
|
||||||
<sect2 id="moving-applets">
|
<sect2 id="moving-applets">
|
||||||
<title>Moving Applets In or Between Panels</title>
|
<title>Moving Applets In or Between Panels</title>
|
||||||
<para>
|
<para>
|
||||||
It is easy to move applets in a <interface>Panel</interface> or
|
It is easy to move applets in a <interface>Panel</interface> or
|
||||||
@ -188,12 +188,12 @@
|
|||||||
other objects, the behavior depends on the global preferences
|
other objects, the behavior depends on the global preferences
|
||||||
you have set for your <interface>Panels</interface> in the
|
you have set for your <interface>Panels</interface> in the
|
||||||
<application>GNOME Control Center</application>: the applet you are
|
<application>GNOME Control Center</application>: the applet you are
|
||||||
moving can switch places with other objects, "push" all objects
|
moving can switch places with other objects, "push" all objects
|
||||||
it meets, or "jump" over all other objects without disturbing
|
it meets, or "jump" over all other objects without disturbing
|
||||||
them. You can also override the default behavior by holding
|
them. You can also override the default behavior by holding
|
||||||
<keycap>Shift</keycap> button (for "push" mode),
|
<keycap>Shift</keycap> button (for "push" mode),
|
||||||
<keycap>Ctrl</keycap> (for "switched" mode), or
|
<keycap>Ctrl</keycap> (for "switched" mode), or
|
||||||
<keycap>Alt</keycap> (for "free" mode, i.e. jumping other other
|
<keycap>Alt</keycap> (for "free" mode, i.e. jumping other other
|
||||||
objects without disturbing them) button while dragging.
|
objects without disturbing them) button while dragging.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
@ -208,7 +208,7 @@
|
|||||||
</para>
|
</para>
|
||||||
</sect2>
|
</sect2>
|
||||||
|
|
||||||
<sect2 id="removing-applets">
|
<sect2 id="removing-applets">
|
||||||
<title>Removing Applets from a Panel</title>
|
<title>Removing Applets from a Panel</title>
|
||||||
<para>
|
<para>
|
||||||
To remove an applet from a <interface>Panel</interface>,
|
To remove an applet from a <interface>Panel</interface>,
|
||||||
@ -220,7 +220,7 @@
|
|||||||
|
|
||||||
|
|
||||||
<!-- #### Intro | The Right-Click Pop-Up Menu ###### -->
|
<!-- #### Intro | The Right-Click Pop-Up Menu ###### -->
|
||||||
<sect1 id="right-click-pop-up-menu">
|
<sect1 id="right-click-pop-up-menu">
|
||||||
<title>The Right-Click Pop-Up Menu</title>
|
<title>The Right-Click Pop-Up Menu</title>
|
||||||
<para>
|
<para>
|
||||||
Clicking the right mouse button on any applet brings up
|
Clicking the right mouse button on any applet brings up
|
||||||
@ -229,7 +229,7 @@
|
|||||||
often has additional items which vary depending on the particular
|
often has additional items which vary depending on the particular
|
||||||
applet.
|
applet.
|
||||||
</para>
|
</para>
|
||||||
<sect2 id="standard-right-click-items">
|
<sect2 id="standard-right-click-items">
|
||||||
<title>Standard Pop-Up Items</title>
|
<title>Standard Pop-Up Items</title>
|
||||||
<para>
|
<para>
|
||||||
All applets should have the following items in their right-click
|
All applets should have the following items in their right-click
|
||||||
@ -297,7 +297,7 @@
|
|||||||
</para>
|
</para>
|
||||||
</sect2>
|
</sect2>
|
||||||
|
|
||||||
<sect2 id="applet-properties-dialog">
|
<sect2 id="applet-properties-dialog">
|
||||||
<title>The Applet Properties Dialog</title>
|
<title>The Applet Properties Dialog</title>
|
||||||
<para>
|
<para>
|
||||||
Many applets have customizable properties. These applets will
|
Many applets have customizable properties. These applets will
|
||||||
@ -305,12 +305,12 @@
|
|||||||
right-click <guimenu>pop-up menu</guimenu> which brings up the
|
right-click <guimenu>pop-up menu</guimenu> which brings up the
|
||||||
<interface>Properties</interface> dialog where you can alter the
|
<interface>Properties</interface> dialog where you can alter the
|
||||||
appearance or behaviour of the applet.
|
appearance or behaviour of the applet.
|
||||||
<figure id="example-props-dialog-fig">
|
<figure id="example-props-dialog-fig">
|
||||||
<title>An Example Applet Properties Dialog</title>
|
<title>An Example Applet Properties Dialog</title>
|
||||||
<screenshot>
|
<screenshot>
|
||||||
<screeninfo>An Example Applets Properties Dialog</screeninfo>
|
<screeninfo>An Example Applets Properties Dialog</screeninfo>
|
||||||
<graphic fileref="applet_props_dialog" format="png"
|
<graphic fileref="applet_props_dialog" format="png"
|
||||||
srccredit="muet">
|
srccredit="muet">
|
||||||
</graphic>
|
</graphic>
|
||||||
</screenshot>
|
</screenshot>
|
||||||
</figure>
|
</figure>
|
||||||
@ -357,7 +357,7 @@
|
|||||||
</para>
|
</para>
|
||||||
</sect2>
|
</sect2>
|
||||||
|
|
||||||
<sect2 id="common-right-click-items">
|
<sect2 id="common-right-click-items">
|
||||||
<title>Other Common Pop-Up Items</title>
|
<title>Other Common Pop-Up Items</title>
|
||||||
<para>
|
<para>
|
||||||
Many applets also have one or more of the following items in their
|
Many applets also have one or more of the following items in their
|
||||||
@ -398,13 +398,13 @@
|
|||||||
</sect2>
|
</sect2>
|
||||||
</sect1>
|
</sect1>
|
||||||
|
|
||||||
<sect1 id="feedback">
|
<sect1 id="feedback">
|
||||||
<title>Feedback</title>
|
<title>Feedback</title>
|
||||||
<sect2 id="reporting-bugs">
|
<sect2 id="reporting-bugs">
|
||||||
<title>Reporting Applet Bugs</title>
|
<title>Reporting Applet Bugs</title>
|
||||||
<para>
|
<para>
|
||||||
GNOME users are encouraged to report bugs to <ulink type="http"
|
GNOME users are encouraged to report bugs to <ulink type="http"
|
||||||
url="http://bugs.gnome.org">The GNOME Bug Tracking
|
url="http://bugs.gnome.org">The GNOME Bug Tracking
|
||||||
System</ulink>. The easiest way to submit bugs is to use the
|
System</ulink>. The easiest way to submit bugs is to use the
|
||||||
<application>Bug Report Tool</application> program by selecting
|
<application>Bug Report Tool</application> program by selecting
|
||||||
<menuchoice>
|
<menuchoice>
|
||||||
@ -416,7 +416,7 @@
|
|||||||
reproduce the the scenario.
|
reproduce the the scenario.
|
||||||
</para>
|
</para>
|
||||||
</sect2>
|
</sect2>
|
||||||
<sect2 id="documentation-feedback">
|
<sect2 id="documentation-feedback">
|
||||||
<title>Providing Feedback</title>
|
<title>Providing Feedback</title>
|
||||||
<para>
|
<para>
|
||||||
GNOME users are welcome to provide suggestions for how
|
GNOME users are welcome to provide suggestions for how
|
||||||
@ -425,27 +425,27 @@
|
|||||||
<application>Bug Report Tool</application> discussed above.
|
<application>Bug Report Tool</application> discussed above.
|
||||||
Suggestions for documentation changes can be emailed directly to
|
Suggestions for documentation changes can be emailed directly to
|
||||||
the documentation author (whose email should be included in the
|
the documentation author (whose email should be included in the
|
||||||
"Authors" section of the document) or by sending an email to
|
"Authors" section of the document) or by sending an email to
|
||||||
<email>docs@gnome.org</email>.
|
<email>docs@gnome.org</email>.
|
||||||
</para>
|
</para>
|
||||||
</sect2>
|
</sect2>
|
||||||
<sect2 id="joining-gnome">
|
<sect2 id="joining-gnome">
|
||||||
<title>Joining GNOME</title>
|
<title>Joining GNOME</title>
|
||||||
<para>
|
<para>
|
||||||
GNOME is a community project, created by hundreds of programmers,
|
GNOME is a community project, created by hundreds of programmers,
|
||||||
documentation writers, icon design artists, web masters, and
|
documentation writers, icon design artists, web masters, and
|
||||||
other people, most of whom work on a volunteer basis. New GNOME
|
other people, most of whom work on a volunteer basis. New GNOME
|
||||||
contributors are always welcome. To join the GNOME team, visit
|
contributors are always welcome. To join the GNOME team, visit
|
||||||
these web sites: developers &mdash; <ulink type="http"
|
these web sites: developers &mdash; <ulink type="http"
|
||||||
url="http://developer.gnome.org">The GNOME Development
|
url="http://developer.gnome.org">The GNOME Development
|
||||||
Site</ulink>, documentation writers &mdash; <ulink type="http"
|
Site</ulink>, documentation writers &mdash; <ulink type="http"
|
||||||
url="http://developer.gnome.org/projects/gdp">The GNOME Documentation
|
url="http://developer.gnome.org/projects/gdp">The GNOME Documentation
|
||||||
Project</ulink>, icon design artists &mdash; <ulink type="http"
|
Project</ulink>, icon design artists &mdash; <ulink type="http"
|
||||||
url="http://gnome-icons.sourceforge.net/">Gnome Icon Web</ulink>,
|
url="http://gnome-icons.sourceforge.net/">Gnome Icon Web</ulink>,
|
||||||
general &mdash; <ulink type="http"
|
general &mdash; <ulink type="http"
|
||||||
url="http://developer.gnome.org/helping/">Helping GNOME</ulink>,
|
url="http://developer.gnome.org/helping/">Helping GNOME</ulink>,
|
||||||
or just join the gnome-list email list (see <ulink type="http"
|
or just join the gnome-list email list (see <ulink type="http"
|
||||||
url="http://www.gnome.org/resources/mailing-lists.html">GNOME Mailing
|
url="http://www.gnome.org/resources/mailing-lists.html">GNOME Mailing
|
||||||
Lists</ulink>) to discuss what you are interested in doing.
|
Lists</ulink>) to discuss what you are interested in doing.
|
||||||
</para>
|
</para>
|
||||||
</sect2>
|
</sect2>
|
||||||
@ -453,7 +453,7 @@
|
|||||||
</chapter>
|
</chapter>
|
||||||
|
|
||||||
<!-- ############### Template Applets ##################### -->
|
<!-- ############### Template Applets ##################### -->
|
||||||
<chapter id="template-applets">
|
<chapter id="template-applets">
|
||||||
<title>Template Applets</title>
|
<title>Template Applets</title>
|
||||||
|
|
||||||
&TEMPLATE-APPLET
|
&TEMPLATE-APPLET
|
||||||
@ -505,27 +505,27 @@
|
|||||||
<!-- stated in a translation approved by the Foundation. -->
|
<!-- stated in a translation approved by the Foundation. -->
|
||||||
|
|
||||||
<!-- ############### GNOMEAPPLET ############### -->
|
<!-- ############### GNOMEAPPLET ############### -->
|
||||||
<sect1 id="GNOMEAPPLET">
|
<sect1 id="GNOMEAPPLET">
|
||||||
<title>GNOMEAPPLET Applet</title>
|
<title>GNOMEAPPLET Applet</title>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
<application>GNOMEAPPLET</application> applet, shown in <xref
|
<application>GNOMEAPPLET</application> applet, shown in <xref
|
||||||
linkend="GNOMEAPPLET-fig">, does this and that. To learn how to
|
linkend="GNOMEAPPLET-fig">, does this and that. To learn how to
|
||||||
add this applet to a <interface>Panel</interface>, see <xref
|
add this applet to a <interface>Panel</interface>, see <xref
|
||||||
linkend="adding-applets">.
|
linkend="adding-applets">.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
|
|
||||||
<figure id="GNOMEAPPLET-fig">
|
<figure id="GNOMEAPPLET-fig">
|
||||||
<title>GNOMEAPPLET</title>
|
<title>GNOMEAPPLET</title>
|
||||||
<screenshot>
|
<screenshot>
|
||||||
<screeninfo>GNOMEAPPLET</screeninfo>
|
<screeninfo>GNOMEAPPLET</screeninfo>
|
||||||
<graphic format="png" fileref="GNOMEAPPLET-fig" srccredit="ME">
|
<graphic format="png" fileref="GNOMEAPPLET-fig" srccredit="ME">
|
||||||
</graphic>
|
</graphic>
|
||||||
</screenshot>
|
</screenshot>
|
||||||
</figure>
|
</figure>
|
||||||
|
|
||||||
<sect2 id="GNOMEAPPLET-usage">
|
<sect2 id="GNOMEAPPLET-usage">
|
||||||
<title>Usage</title>
|
<title>Usage</title>
|
||||||
<para>
|
<para>
|
||||||
This applet does nothing. To use it, just
|
This applet does nothing. To use it, just
|
||||||
@ -533,18 +533,18 @@
|
|||||||
</para>
|
</para>
|
||||||
</sect2>
|
</sect2>
|
||||||
|
|
||||||
<sect2 id="GNOMEAPPLET-right-click">
|
<sect2 id="GNOMEAPPLET-right-click">
|
||||||
<title>Right-Click Pop-Up Menu Items</title>
|
<title>Right-Click Pop-Up Menu Items</title>
|
||||||
<para>
|
<para>
|
||||||
In addition to the standard menu items (see <xref
|
In addition to the standard menu items (see <xref
|
||||||
linkend="standard-right-click-items">), the right-click pop-up menu has
|
linkend="standard-right-click-items">), the right-click pop-up menu has
|
||||||
the following items:
|
the following items:
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
<guimenuitem>Properties...</guimenuitem> &mdash; This menu
|
<guimenuitem>Properties...</guimenuitem> &mdash; This menu
|
||||||
item opens the <interface>Properties</interface> dialog (see
|
item opens the <interface>Properties</interface> dialog (see
|
||||||
<xref linkend="GNOMEAPPLET-properties">) which allows you to
|
<xref linkend="GNOMEAPPLET-properties">) which allows you to
|
||||||
customize the appearance and behavior of this applet.
|
customize the appearance and behavior of this applet.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
@ -552,27 +552,27 @@
|
|||||||
<para>
|
<para>
|
||||||
<guimenuitem>Run Hello World...</guimenuitem> &mdash; This
|
<guimenuitem>Run Hello World...</guimenuitem> &mdash; This
|
||||||
menu item starts the program <application>Hello
|
menu item starts the program <application>Hello
|
||||||
World</application>, used to say "hello" to the world.
|
World</application>, used to say "hello" to the world.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
</para>
|
</para>
|
||||||
</sect2>
|
</sect2>
|
||||||
|
|
||||||
<sect2 id="GNOMEAPPLET-properties">
|
<sect2 id="GNOMEAPPLET-properties">
|
||||||
<title>Properties</title>
|
<title>Properties</title>
|
||||||
<para>
|
<para>
|
||||||
You can configure <application>GNOMEAPPLET</application> applet by
|
You can configure <application>GNOMEAPPLET</application> applet by
|
||||||
right-clicking on the applet and choosing the
|
right-clicking on the applet and choosing the
|
||||||
<guimenuitem>Properties...</guimenuitem> menu item. This will open the
|
<guimenuitem>Properties...</guimenuitem> menu item. This will open the
|
||||||
<interface>Properties</interface> dialog, shown in <xref
|
<interface>Properties</interface> dialog, shown in <xref
|
||||||
linkend="GNOMEAPPLET-properties-fig">.
|
linkend="GNOMEAPPLET-properties-fig">.
|
||||||
</para>
|
</para>
|
||||||
<figure id="GNOMEAPPLET-properties-fig">
|
<figure id="GNOMEAPPLET-properties-fig">
|
||||||
<title>Properties Dialog</title>
|
<title>Properties Dialog</title>
|
||||||
<screenshot>
|
<screenshot>
|
||||||
<screeninfo>Properties Dialog</screeninfo>
|
<screeninfo>Properties Dialog</screeninfo>
|
||||||
<graphic format="png" fileref="GNOMEAPPLET-properties" srccredit="ME">
|
<graphic format="png" fileref="GNOMEAPPLET-properties" srccredit="ME">
|
||||||
</graphic>
|
</graphic>
|
||||||
</screenshot>
|
</screenshot>
|
||||||
</figure>
|
</figure>
|
||||||
@ -588,11 +588,11 @@
|
|||||||
dialog, including descriptions of the <guibutton>OK</guibutton>,
|
dialog, including descriptions of the <guibutton>OK</guibutton>,
|
||||||
<guibutton>Apply</guibutton>, <guibutton>Cancel</guibutton>, and
|
<guibutton>Apply</guibutton>, <guibutton>Cancel</guibutton>, and
|
||||||
<guibutton>Help</guibutton> buttons, see <xref
|
<guibutton>Help</guibutton> buttons, see <xref
|
||||||
linkend="applet-properties-dialog">.
|
linkend="applet-properties-dialog">.
|
||||||
</para>
|
</para>
|
||||||
</sect2>
|
</sect2>
|
||||||
|
|
||||||
<sect2 id="GNOMEAPPLET-bugs">
|
<sect2 id="GNOMEAPPLET-bugs">
|
||||||
<title> Known Bugs and Limitations</title>
|
<title> Known Bugs and Limitations</title>
|
||||||
<para>
|
<para>
|
||||||
There are no known bugs in the
|
There are no known bugs in the
|
||||||
@ -600,7 +600,7 @@
|
|||||||
</para>
|
</para>
|
||||||
</sect2>
|
</sect2>
|
||||||
|
|
||||||
<sect2 id="GNOMEAPPLET-authors">
|
<sect2 id="GNOMEAPPLET-authors">
|
||||||
<title>Authors</title>
|
<title>Authors</title>
|
||||||
<para>
|
<para>
|
||||||
This applet was writen by HACKER-NAME
|
This applet was writen by HACKER-NAME
|
||||||
@ -608,7 +608,7 @@
|
|||||||
which you are reading now was written by
|
which you are reading now was written by
|
||||||
YOUR-NAME <email>YOUR-EMAIL</email>. For information on submitting
|
YOUR-NAME <email>YOUR-EMAIL</email>. For information on submitting
|
||||||
bug reports and suggestions for improvements, see <xref
|
bug reports and suggestions for improvements, see <xref
|
||||||
linkend="feedback">.
|
linkend="feedback">.
|
||||||
</para>
|
</para>
|
||||||
</sect2>
|
</sect2>
|
||||||
|
|
||||||
|
|||||||
@ -83,14 +83,14 @@
|
|||||||
irc.gnome.org is another option for contacting GDP members.
|
irc.gnome.org is another option for contacting GDP members.
|
||||||
</p></div></div><div class="sect2"><a name="notation"></a><div class="titlepage"><div><h3 class="title"><a name="notation"></a>Notation and Conventions</h3></div></div><p>
|
</p></div></div><div class="sect2"><a name="notation"></a><div class="titlepage"><div><h3 class="title"><a name="notation"></a>Notation and Conventions</h3></div></div><p>
|
||||||
This Handbook uses the following notation:
|
This Handbook uses the following notation:
|
||||||
<div class="informaltable" id="id2807857"><a name="id2807857"></a><table border="0"><colgroup><col><col></colgroup><tbody><tr><td><tt>/usr/bin</tt></td><td>
|
<div class="informaltable" id="id2814391"><a name="id2814391"></a><table border="0"><colgroup><col><col></colgroup><tbody><tr><td><tt>/usr/bin</tt></td><td>
|
||||||
Directory
|
Directory
|
||||||
</td></tr><tr><td><tt>foo.sgml</tt></td><td>
|
</td></tr><tr><td><tt>foo.sgml</tt></td><td>
|
||||||
Filename
|
Filename
|
||||||
</td></tr><tr><td><b>command</b></td><td>
|
</td></tr><tr><td><b>command</b></td><td>
|
||||||
Command or text that would be typed.
|
Command or text that would be typed.
|
||||||
</td></tr><tr><td><b><i><tt>replaceable</tt></i></b></td><td>
|
</td></tr><tr><td><b><i><tt>replaceable</tt></i></b></td><td>
|
||||||
"Variable" text that can be replaced.
|
"Variable" text that can be replaced.
|
||||||
</td></tr><tr><td><tt>Program or Doc Code</tt></td><td>Program or document code</td></tr></tbody></table></div>
|
</td></tr><tr><td><tt>Program or Doc Code</tt></td><td>Program or document code</td></tr></tbody></table></div>
|
||||||
</p></div><div class="sect2"><a name="about"></a><div class="titlepage"><div><h3 class="title"><a name="about"></a>About This Handbook</h3></div></div><p>
|
</p></div><div class="sect2"><a name="about"></a><div class="titlepage"><div><h3 class="title"><a name="about"></a>About This Handbook</h3></div></div><p>
|
||||||
This Handbook is a guide for both writing documentation for
|
This Handbook is a guide for both writing documentation for
|
||||||
|
|||||||
@ -1,7 +1,7 @@
|
|||||||
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Getting Started Writing GNOME Documentation</title><meta name="generator" content="DocBook XSL Stylesheets V1.40"><link rel="home" href="index.html" title="The GNOME Handbook of Writing Software Documentation"><link rel="up" href="index.html" title="The GNOME Handbook of Writing Software Documentation"><link rel="previous" href="index.html" title="The GNOME Handbook of Writing Software Documentation"><link rel="next" href="indexs03.html" title="The GNOME Documentation System"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Getting Started Writing GNOME Documentation</th></tr><tr><td width="20%" align="left"><a href="index.html">Prev</a><3E></td><th width="60%" align="center"><3E></th><td width="20%" align="right"><3E><a href="indexs03.html">Next</a></td></tr></table><hr></div><div class="sect1"><a name="gettingstarted"></a><div class="titlepage"><div><h2 class="title" style="clear: both"><a name="gettingstarted"></a>Getting Started Writing GNOME Documentation</h2></div></div><div class="sect2"><a name="selecting"></a><div class="titlepage"><div><h3 class="title"><a name="selecting"></a>Selecting A Document</h3></div></div><div class="sect3"><a name="know"></a><div class="titlepage"><div><h4 class="title"><a name="know"></a>Document Something You Know</h4></div></div><p>
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Getting Started Writing GNOME Documentation</title><meta name="generator" content="DocBook XSL Stylesheets V1.40"><link rel="home" href="index.html" title="The GNOME Handbook of Writing Software Documentation"><link rel="up" href="index.html" title="The GNOME Handbook of Writing Software Documentation"><link rel="previous" href="index.html" title="The GNOME Handbook of Writing Software Documentation"><link rel="next" href="indexs03.html" title="The GNOME Documentation System"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Getting Started Writing GNOME Documentation</th></tr><tr><td width="20%" align="left"><a href="index.html">Prev</a><3E></td><th width="60%" align="center"><3E></th><td width="20%" align="right"><3E><a href="indexs03.html">Next</a></td></tr></table><hr></div><div class="sect1"><a name="gettingstarted"></a><div class="titlepage"><div><h2 class="title" style="clear: both"><a name="gettingstarted"></a>Getting Started Writing GNOME Documentation</h2></div></div><div class="sect2"><a name="selecting"></a><div class="titlepage"><div><h3 class="title"><a name="selecting"></a>Selecting A Document</h3></div></div><div class="sect3"><a name="know"></a><div class="titlepage"><div><h4 class="title"><a name="know"></a>Document Something You Know</h4></div></div><p>
|
||||||
The most frequently asked question of new contributors who
|
The most frequently asked question of new contributors who
|
||||||
join the GDP is "which document should I start
|
join the GDP is "which document should I start
|
||||||
with?". Because most people involved are volunteers, we do
|
with?". Because most people involved are volunteers, we do
|
||||||
not <i>assign</i> projects and applications to
|
not <i>assign</i> projects and applications to
|
||||||
write documents for. The first step is all yours - you must
|
write documents for. The first step is all yours - you must
|
||||||
decide what about GNOME interests you most and find out if
|
decide what about GNOME interests you most and find out if
|
||||||
@ -41,7 +41,7 @@
|
|||||||
help. The <i>DocTable</i> also allows
|
help. The <i>DocTable</i> also allows
|
||||||
people to make announcements and suggestions and to discuss
|
people to make announcements and suggestions and to discuss
|
||||||
issues in the comments section.
|
issues in the comments section.
|
||||||
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2801402"></a>Note</h3><p>
|
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2810555"></a>Note</h3><p>
|
||||||
Note that the information in the
|
Note that the information in the
|
||||||
<i>DocTable</i> may not always be up-to-date
|
<i>DocTable</i> may not always be up-to-date
|
||||||
or accurate. When you assign yourself to documenting an
|
or accurate. When you assign yourself to documenting an
|
||||||
@ -53,7 +53,7 @@
|
|||||||
this for documentation, not least of which is the single
|
this for documentation, not least of which is the single
|
||||||
source nature of SGML. To contribute to the GDP you should
|
source nature of SGML. To contribute to the GDP you should
|
||||||
learn to use DocBook.
|
learn to use DocBook.
|
||||||
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2801489"></a>NOTE</h3><p>
|
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2810638"></a>NOTE</h3><p>
|
||||||
To get started writing for the GDP you do not need to rush
|
To get started writing for the GDP you do not need to rush
|
||||||
out and learn DocBook - if you feel it is too much to handle
|
out and learn DocBook - if you feel it is too much to handle
|
||||||
for now, you can submit plain ASCII text to the <a href="http://mail.gnome.org/mailman/listinfo/gnome-doc-list/" target="_top">
|
for now, you can submit plain ASCII text to the <a href="http://mail.gnome.org/mailman/listinfo/gnome-doc-list/" target="_top">
|
||||||
@ -99,25 +99,25 @@
|
|||||||
your output document appearance subtly vary between the two
|
your output document appearance subtly vary between the two
|
||||||
DTD's. To install the GDP custom DTD with PNG image support
|
DTD's. To install the GDP custom DTD with PNG image support
|
||||||
by hand:
|
by hand:
|
||||||
</p><div class="itemizedlist"><ul><li style="list-style-type: opencircle"><p><a name="id2801874"></a>
|
</p><div class="itemizedlist"><ul><li style="list-style-type: opencircle"><p><a name="id2811052"></a>
|
||||||
Download <a href="http://www.labs.redhat.com/png/png-support.html" target="_top">the
|
Download <a href="http://www.labs.redhat.com/png/png-support.html" target="_top">the
|
||||||
GDP DocBook DTD for PNG support</a> and install it
|
GDP DocBook DTD for PNG support</a> and install it
|
||||||
where you keep your DTD's. (On Red Hat use <tt>/usr/lib/sgml/</tt>.) Note that
|
where you keep your DTD's. (On Red Hat use <tt>/usr/lib/sgml/</tt>.) Note that
|
||||||
the 3.0 DTD is missing support for the
|
the 3.0 DTD is missing support for the
|
||||||
<tt><legalnotice></tt> tag, so it is
|
<tt><legalnotice></tt> tag, so it is
|
||||||
recommended that you use version 3.1
|
recommended that you use version 3.1
|
||||||
</p></li><li style="list-style-type: disc"><p><a name="id2802204"></a>
|
</p></li><li style="list-style-type: disc"><p><a name="id2811114"></a>
|
||||||
Add the new DTD to your SGML CATALOG file. The location
|
Add the new DTD to your SGML CATALOG file. The location
|
||||||
of your SGML CATALOG file may vary depending upon your
|
of your SGML CATALOG file may vary depending upon your
|
||||||
distribution. (On Red Hat it is usually in
|
distribution. (On Red Hat it is usually in
|
||||||
/usr/lib/sgml/CATALOG.) Add the following line to this
|
/usr/lib/sgml/CATALOG.) Add the following line to this
|
||||||
file:
|
file:
|
||||||
<pre class="programlisting">
|
<pre class="programlisting">
|
||||||
PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.0//EN" "png-support-3.0.dtd"
|
PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.0//EN" "png-support-3.0.dtd"
|
||||||
</pre>
|
</pre>
|
||||||
If you are using the 3.1 DTD, use:
|
If you are using the 3.1 DTD, use:
|
||||||
<pre class="programlisting">
|
<pre class="programlisting">
|
||||||
PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN" "png-support-3.1.dtd"
|
PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN" "png-support-3.1.dtd"
|
||||||
</pre>
|
</pre>
|
||||||
</p></li></ul></div><p>
|
</p></li></ul></div><p>
|
||||||
Alternately, you can download and install the
|
Alternately, you can download and install the
|
||||||
@ -130,14 +130,14 @@ PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN" "png-support-
|
|||||||
</p><p>
|
</p><p>
|
||||||
Articles:
|
Articles:
|
||||||
<pre class="programlisting">
|
<pre class="programlisting">
|
||||||
<!DOCTYPE Article PUBLIC "-//GNOME//DTD DocBook PNG Variant
|
<!DOCTYPE Article PUBLIC "-//GNOME//DTD DocBook PNG Variant
|
||||||
V1.1//EN"[]>
|
V1.1//EN"[]>
|
||||||
</pre>
|
</pre>
|
||||||
</p><p>
|
</p><p>
|
||||||
Books:
|
Books:
|
||||||
<pre class="programlisting">
|
<pre class="programlisting">
|
||||||
<!DOCTYPE Book PUBLIC "-//GNOME//DTD DocBook PNG Variant
|
<!DOCTYPE Book PUBLIC "-//GNOME//DTD DocBook PNG Variant
|
||||||
V1.1//EN"[]>
|
V1.1//EN"[]>
|
||||||
</pre>
|
</pre>
|
||||||
</p></div><div class="sect3"><a name="editors"></a><div class="titlepage"><div><h4 class="title"><a name="editors"></a>Editors</h4></div></div><p>
|
</p></div><div class="sect3"><a name="editors"></a><div class="titlepage"><div><h4 class="title"><a name="editors"></a>Editors</h4></div></div><p>
|
||||||
There are many editors on Linux and UNIX systems available
|
There are many editors on Linux and UNIX systems available
|
||||||
@ -184,7 +184,7 @@ V1.1//EN"[]>
|
|||||||
the command <tt>$</tt><b>db2ps
|
the command <tt>$</tt><b>db2ps
|
||||||
mydocument.sgml</b>, after which you can print out or
|
mydocument.sgml</b>, after which you can print out or
|
||||||
view the resulting .ps file.
|
view the resulting .ps file.
|
||||||
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2922151"></a>NOTE</h3><p>
|
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2811592"></a>NOTE</h3><p>
|
||||||
The html files you get will not look quite the same as the
|
The html files you get will not look quite the same as the
|
||||||
documentation distributed with GNOME unless you have the
|
documentation distributed with GNOME unless you have the
|
||||||
custom stylesheets installed on your machine. DocBook
|
custom stylesheets installed on your machine. DocBook
|
||||||
@ -210,7 +210,7 @@ V1.1//EN"[]>
|
|||||||
<title>My Image</title>
|
<title>My Image</title>
|
||||||
<screenshot>
|
<screenshot>
|
||||||
<screeninfo>Sample GNOME Display</screeninfo>
|
<screeninfo>Sample GNOME Display</screeninfo>
|
||||||
<graphic format="png" fileref="myfile" srccredit="me">
|
<graphic format="png" fileref="myfile" srccredit="me">
|
||||||
</graphic>
|
</graphic>
|
||||||
</screenshot>
|
</screenshot>
|
||||||
</figure>
|
</figure>
|
||||||
@ -235,24 +235,24 @@ V1.1//EN"[]>
|
|||||||
There are many resources available to help you learn DocBook.
|
There are many resources available to help you learn DocBook.
|
||||||
The following resources on the web are useful for learning
|
The following resources on the web are useful for learning
|
||||||
DocBook:
|
DocBook:
|
||||||
</p><div class="itemizedlist"><ul><li style="list-style-type: disc"><p><a name="id2922441"></a>
|
</p><div class="itemizedlist"><ul><li style="list-style-type: disc"><p><a name="id2933577"></a>
|
||||||
<a href="http://www.docbook.org" target="_top">http://www.docbook.org</a> - Norman
|
<a href="http://www.docbook.org" target="_top">http://www.docbook.org</a> - Norman
|
||||||
Walsh's <i>DocBook: The Definitive
|
Walsh's <i>DocBook: The Definitive
|
||||||
Guide</i>. Online O'Reilly book on using
|
Guide</i>. Online O'Reilly book on using
|
||||||
DocBook. Contains an excellent element reference. May be
|
DocBook. Contains an excellent element reference. May be
|
||||||
too formal for a beginner.
|
too formal for a beginner.
|
||||||
</p></li><li style="list-style-type: disc"><p><a name="id2922486"></a>
|
</p></li><li style="list-style-type: disc"><p><a name="id2933624"></a>
|
||||||
<a href="http://www.oswg.org/oswg-nightly/oswg/en_US.ISO_8859-1/articles/DocBook-Intro/docbook-intro/index.html" target="_top">A Practical Introduction to DocBook</a>
|
<a href="http://www.oswg.org/oswg-nightly/oswg/en_US.ISO_8859-1/articles/DocBook-Intro/docbook-intro/index.html" target="_top">A Practical Introduction to DocBook</a>
|
||||||
- The Open Source Writers Group's introduction to using
|
- The Open Source Writers Group's introduction to using
|
||||||
DocBook. This is an excellent HOW-TO type article on
|
DocBook. This is an excellent HOW-TO type article on
|
||||||
getting started.
|
getting started.
|
||||||
</p></li><li style="list-style-type: disc"><p><a name="id2922526"></a>
|
</p></li><li style="list-style-type: disc"><p><a name="id2933666"></a>
|
||||||
<a href="http://nis-www.lanl.gov/~rosalia/mydocs/docbook-intro/docbook-intro.html" target="_top">Getting Going with DocBook: Notes for
|
<a href="http://nis-www.lanl.gov/~rosalia/mydocs/docbook-intro/docbook-intro.html" target="_top">Getting Going with DocBook: Notes for
|
||||||
Hackers</a> - Mark Galassi's introduction to DocBook
|
Hackers</a> - Mark Galassi's introduction to DocBook
|
||||||
for hackers. This has to be one of the first
|
for hackers. This has to be one of the first
|
||||||
introductions to DocBook ever - still as good as it ever
|
introductions to DocBook ever - still as good as it ever
|
||||||
was.
|
was.
|
||||||
</p></li><li style="list-style-type: disc"><p><a name="id2922566"></a>
|
</p></li><li style="list-style-type: disc"><p><a name="id2933704"></a>
|
||||||
<a href="http://www.freebsd.org/tutorials/docproj-primer/" target="_top">
|
<a href="http://www.freebsd.org/tutorials/docproj-primer/" target="_top">
|
||||||
FreeBSD Documentation Project Primer for New
|
FreeBSD Documentation Project Primer for New
|
||||||
Contributors</a> - FreeBSD documentation project
|
Contributors</a> - FreeBSD documentation project
|
||||||
@ -265,7 +265,7 @@ V1.1//EN"[]>
|
|||||||
</p><p>
|
</p><p>
|
||||||
The following sections of this document are designed to help
|
The following sections of this document are designed to help
|
||||||
documentation authors write correct and consistent DocBook:
|
documentation authors write correct and consistent DocBook:
|
||||||
</p><div class="itemizedlist"><ul><li style="list-style-type: disc"><p><a name="id2922642"></a>
|
</p><div class="itemizedlist"><ul><li style="list-style-type: disc"><p><a name="id2933779"></a>
|
||||||
<a href="indexs04.html" title="DocBook Basics ">the section called “DocBook Basics ”</a> - Descriptions of
|
<a href="indexs04.html" title="DocBook Basics ">the section called “DocBook Basics ”</a> - Descriptions of
|
||||||
commonly used DocBook tags.
|
commonly used DocBook tags.
|
||||||
</p></li></ul></div><p>
|
</p></li></ul></div><p>
|
||||||
@ -333,11 +333,11 @@ V1.1//EN"[]>
|
|||||||
</p></div><div class="sect3"><a name="screenshotfiles"></a><div class="titlepage"><div><h4 class="title"><a name="screenshotfiles"></a>Screenshot Files</h4></div></div><p>
|
</p></div><div class="sect3"><a name="screenshotfiles"></a><div class="titlepage"><div><h4 class="title"><a name="screenshotfiles"></a>Screenshot Files</h4></div></div><p>
|
||||||
Screenshots should be kept in the main documentation
|
Screenshots should be kept in the main documentation
|
||||||
directory with your SGML file for applets, or should be
|
directory with your SGML file for applets, or should be
|
||||||
kept in a directory called "figs" for application and other
|
kept in a directory called "figs" for application and other
|
||||||
documentation. After you use <b>db2html</b> to
|
documentation. After you use <b>db2html</b> to
|
||||||
convert your SGML file to HTML (see <a href="indexs02.html#make-output" title="Creating Something Useful with your Docs">the section called “Creating Something Useful with your Docs”</a>), you will need to copy your
|
convert your SGML file to HTML (see <a href="indexs02.html#make-output" title="Creating Something Useful with your Docs">the section called “Creating Something Useful with your Docs”</a>), you will need to copy your
|
||||||
screenshots (either the individual PNG files for applet
|
screenshots (either the individual PNG files for applet
|
||||||
documentation, or the whole "figs" directory for other
|
documentation, or the whole "figs" directory for other
|
||||||
documentation) into the newly created HTML directory. Note
|
documentation) into the newly created HTML directory. Note
|
||||||
that every time you use <b>db2html</b> the HTML
|
that every time you use <b>db2html</b> the HTML
|
||||||
directory is erased and rewritten, so do not store your only
|
directory is erased and rewritten, so do not store your only
|
||||||
@ -380,7 +380,7 @@ V1.1//EN"[]>
|
|||||||
CVSROOT=':pserver:anonymous@anoncvs.gnome.org:/cvs/gnome'</b>
|
CVSROOT=':pserver:anonymous@anoncvs.gnome.org:/cvs/gnome'</b>
|
||||||
and then login with <b>cvs login</b>(there is no
|
and then login with <b>cvs login</b>(there is no
|
||||||
password, just hit return). As an example, we will use the
|
password, just hit return). As an example, we will use the
|
||||||
"gnome-docu/gdp" module which contains this and several
|
"gnome-docu/gdp" module which contains this and several
|
||||||
other documents. To check these documents out for the first
|
other documents. To check these documents out for the first
|
||||||
time, type <b>cvs -z3 checkout
|
time, type <b>cvs -z3 checkout
|
||||||
gnome-docu/gdp</b>. After you have this document
|
gnome-docu/gdp</b>. After you have this document
|
||||||
|
|||||||
@ -66,7 +66,7 @@
|
|||||||
to query any part (button, widget, etc.) of an application
|
to query any part (button, widget, etc.) of an application
|
||||||
window. This is done by either entering a CS Help mode by
|
window. This is done by either entering a CS Help mode by
|
||||||
clicking on an icon or by right clicking on the application
|
clicking on an icon or by right clicking on the application
|
||||||
part and selecting "What's This" or whatever is decided on
|
part and selecting "What's This" or whatever is decided on
|
||||||
at the time. Context sensitive help is described in more
|
at the time. Context sensitive help is described in more
|
||||||
detail in <a href="indexs10.html" title="Writing Context Sensitive Help (coming in GNOME-2.0)">the section called “Writing Context Sensitive Help (coming in GNOME-2.0)”</a>
|
detail in <a href="indexs10.html" title="Writing Context Sensitive Help (coming in GNOME-2.0)">the section called “Writing Context Sensitive Help (coming in GNOME-2.0)”</a>
|
||||||
below.
|
below.
|
||||||
|
|||||||
@ -46,8 +46,8 @@
|
|||||||
</p><p>
|
</p><p>
|
||||||
Using 'content' as the elements to define the text of a document also
|
Using 'content' as the elements to define the text of a document also
|
||||||
allows for search engines to make use of the actual elements to make a
|
allows for search engines to make use of the actual elements to make a
|
||||||
"smarter search". For example, if you are searching for all documents
|
"smarter search". For example, if you are searching for all documents
|
||||||
written by the author "Susie" your search engine could be made smart
|
written by the author "Susie" your search engine could be made smart
|
||||||
enough to only search <author> elements, making for a faster and more
|
enough to only search <author> elements, making for a faster and more
|
||||||
accurate search.
|
accurate search.
|
||||||
</p><p>
|
</p><p>
|
||||||
@ -71,7 +71,7 @@
|
|||||||
ready for this transistion, it is <i>strongly
|
ready for this transistion, it is <i>strongly
|
||||||
advised</i> that the documentation writers conform to XML
|
advised</i> that the documentation writers conform to XML
|
||||||
syntax rules. Here are most important differences:
|
syntax rules. Here are most important differences:
|
||||||
</p><div class="variablelist"><dl><dt><a name="id2925078"></a><span class="term"> <i>Minimization</i></span></dt><dd><p><a name="id2925097"></a>
|
</p><div class="variablelist"><dl><dt><a name="id2936091"></a><span class="term"> <i>Minimization</i></span></dt><dd><p><a name="id2936110"></a>
|
||||||
It is possible with some implementations of SGML to use
|
It is possible with some implementations of SGML to use
|
||||||
minimizations to close elements in a document by using
|
minimizations to close elements in a document by using
|
||||||
</>, for example:
|
</>, for example:
|
||||||
@ -82,17 +82,17 @@
|
|||||||
if you are using Emacs with psgml
|
if you are using Emacs with psgml
|
||||||
mode, you can also use menu command
|
mode, you can also use menu command
|
||||||
Modify->Normalize.
|
Modify->Normalize.
|
||||||
</p></dd><dt><a name="id2925210"></a><span class="term"> <i>Self-closing tags</i></span></dt><dd><p><a name="id2925229"></a>
|
</p></dd><dt><a name="id2936225"></a><span class="term"> <i>Self-closing tags</i></span></dt><dd><p><a name="id2936244"></a>
|
||||||
Also, in SGML some tags are allowed not to have closing
|
Also, in SGML some tags are allowed not to have closing
|
||||||
tags. For example, it is legal for
|
tags. For example, it is legal for
|
||||||
<tt><xref></tt> not to have a closing tag:
|
<tt><xref></tt> not to have a closing tag:
|
||||||
<tt><tt><xref
|
<tt><tt><xref
|
||||||
linkend="someid"></tt></tt>. In
|
linkend="someid"></tt></tt>. In
|
||||||
XML, it is illegal; instead, you should use
|
XML, it is illegal; instead, you should use
|
||||||
<tt><tt><xref
|
<tt><tt><xref
|
||||||
linkend="someid"/></tt></tt> (note the
|
linkend="someid"/></tt></tt> (note the
|
||||||
slash!).
|
slash!).
|
||||||
</p></dd><dt><a name="id2925293"></a><span class="term"> <i>Case sensitive tags</i></span></dt><dd><p><a name="id2925311"></a>
|
</p></dd><dt><a name="id2936311"></a><span class="term"> <i>Case sensitive tags</i></span></dt><dd><p><a name="id2936327"></a>
|
||||||
In XML, unlike SGML, tags are case-senstive
|
In XML, unlike SGML, tags are case-senstive
|
||||||
<tt><title></tt> and
|
<tt><title></tt> and
|
||||||
<tt><TITLE></tt> are different tags!
|
<tt><TITLE></tt> are different tags!
|
||||||
@ -145,11 +145,11 @@
|
|||||||
|
|
||||||
<pre class="programlisting">
|
<pre class="programlisting">
|
||||||
|
|
||||||
<figure id="shot1">
|
<figure id="shot1">
|
||||||
<title>Screenshot</title>
|
<title>Screenshot</title>
|
||||||
<screenshot>
|
<screenshot>
|
||||||
<screeninfo>Screenshot of a program</screeninfo>
|
<screeninfo>Screenshot of a program</screeninfo>
|
||||||
<graphic format="PNG" fileref="figures/example_screenshot" srccredit="ME">
|
<graphic format="PNG" fileref="figures/example_screenshot" srccredit="ME">
|
||||||
</graphic>
|
</graphic>
|
||||||
</screenshot>
|
</screenshot>
|
||||||
</figure>
|
</figure>
|
||||||
@ -158,7 +158,7 @@
|
|||||||
actual file name (without extension). The result will look like this:
|
actual file name (without extension). The result will look like this:
|
||||||
|
|
||||||
<div class="figure"><p><a name="shot1"></a><b>Figure 1. Screenshot</b></p><div class="screenshot"><p><img src="figures/example_screenshot"></p></div></div>
|
<div class="figure"><p><a name="shot1"></a><b>Figure 1. Screenshot</b></p><div class="screenshot"><p><img src="figures/example_screenshot"></p></div></div>
|
||||||
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2925829"></a>NOTE</h3><p>
|
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2936851"></a>NOTE</h3><p>
|
||||||
Notice in this example that the screenshot file name does
|
Notice in this example that the screenshot file name does
|
||||||
not include the file type extension -- to find out
|
not include the file type extension -- to find out
|
||||||
why, please read <a href="indexs02.html#jadeimages" title="Images in DocBook Tools">the section called “Images in DocBook Tools”</a>.
|
why, please read <a href="indexs02.html#jadeimages" title="Images in DocBook Tools">the section called “Images in DocBook Tools”</a>.
|
||||||
@ -206,7 +206,7 @@ make: *** No rule to make target `love'. Stop.
|
|||||||
Note the use of tags <tt><prompt></tt> and
|
Note the use of tags <tt><prompt></tt> and
|
||||||
<tt><userinput></tt> for marking system prompt
|
<tt><userinput></tt> for marking system prompt
|
||||||
and commands entered by user.
|
and commands entered by user.
|
||||||
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2926052"></a>NOTE</h3><p>
|
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2937067"></a>NOTE</h3><p>
|
||||||
Note that both <tt><programlisting></tt>
|
Note that both <tt><programlisting></tt>
|
||||||
and <tt><screen></tt> preserve linebreaks,
|
and <tt><screen></tt> preserve linebreaks,
|
||||||
but interpret SGML tags (unlike LaTeX
|
but interpret SGML tags (unlike LaTeX
|
||||||
@ -219,7 +219,7 @@ make: *** No rule to make target `love'. Stop.
|
|||||||
<tt><itemizedlist></tt>,
|
<tt><itemizedlist></tt>,
|
||||||
<tt><orderedlist></tt>, and
|
<tt><orderedlist></tt>, and
|
||||||
<tt><variablelist></tt>.
|
<tt><variablelist></tt>.
|
||||||
</p><div class="variablelist"><dl><dt><a name="id2926168"></a><span class="term"> <tt><itemizedlist></tt></span></dt><dd><p><a name="id2926188"></a>
|
</p><div class="variablelist"><dl><dt><a name="id2937185"></a><span class="term"> <tt><itemizedlist></tt></span></dt><dd><p><a name="id2937205"></a>
|
||||||
This is the simplest unnumbered list, parallel to
|
This is the simplest unnumbered list, parallel to
|
||||||
<tt><ul></tt> in HTML. Here is an example:
|
<tt><ul></tt> in HTML. Here is an example:
|
||||||
<pre class="programlisting">
|
<pre class="programlisting">
|
||||||
@ -234,7 +234,7 @@ make: *** No rule to make target `love'. Stop.
|
|||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
<guilabel>Show hidden files</guilabel> &mdash; This will
|
<guilabel>Show hidden files</guilabel> &mdash; This will
|
||||||
show all "dot files" or files that begin with a dot. This
|
show all "dot files" or files that begin with a dot. This
|
||||||
files typically include configuration files and directories.
|
files typically include configuration files and directories.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
@ -250,16 +250,16 @@ make: *** No rule to make target `love'. Stop.
|
|||||||
|
|
||||||
</pre>
|
</pre>
|
||||||
and output:
|
and output:
|
||||||
</p><div class="itemizedlist"><ul><li><p><a name="id2926231"></a>
|
</p><div class="itemizedlist"><ul><li><p><a name="id2937244"></a>
|
||||||
Show backup files --
|
Show backup files --
|
||||||
This will show any backup file that might be on
|
This will show any backup file that might be on
|
||||||
your system.
|
your system.
|
||||||
</p></li><li><p><a name="id2926278"></a>
|
</p></li><li><p><a name="id2937304"></a>
|
||||||
Show hidden files --
|
Show hidden files --
|
||||||
This will show all "dot files" or files that
|
This will show all "dot files" or files that
|
||||||
begin with a dot. This files typically include
|
begin with a dot. This files typically include
|
||||||
configuration files and directories.
|
configuration files and directories.
|
||||||
</p></li><li><p><a name="id2926310"></a>
|
</p></li><li><p><a name="id2937335"></a>
|
||||||
Mix files and directories
|
Mix files and directories
|
||||||
-- This option will display files and
|
-- This option will display files and
|
||||||
directories in the order you sort them instead
|
directories in the order you sort them instead
|
||||||
@ -277,20 +277,20 @@ make: *** No rule to make target `love'. Stop.
|
|||||||
or -- if none of
|
or -- if none of
|
||||||
this applies -- use
|
this applies -- use
|
||||||
<a href="indexs04.html#gui" title="GUI elements"><tt><emphasis></tt></a>.
|
<a href="indexs04.html#gui" title="GUI elements"><tt><emphasis></tt></a>.
|
||||||
</p></dd><dt><a name="id2926483"></a><span class="term"> <tt><orderedlist></tt></span></dt><dd><p><a name="id2926502"></a>
|
</p></dd><dt><a name="id2937507"></a><span class="term"> <tt><orderedlist></tt></span></dt><dd><p><a name="id2937525"></a>
|
||||||
This list is completely analogous to
|
This list is completely analogous to
|
||||||
<tt><itemizedlist></tt> and has the same
|
<tt><itemizedlist></tt> and has the same
|
||||||
syntax, but it produces numbered list. By default,
|
syntax, but it produces numbered list. By default,
|
||||||
this list uses Arabic numerals for numbering entries;
|
this list uses Arabic numerals for numbering entries;
|
||||||
you can override this using <tt>numeration</tt>,
|
you can override this using <tt>numeration</tt>,
|
||||||
for example <tt><orderedlist
|
for example <tt><orderedlist
|
||||||
numeration="lowerroman"></tt>. Possible values of
|
numeration="lowerroman"></tt>. Possible values of
|
||||||
these attribute are <tt>arabic</tt>,
|
these attribute are <tt>arabic</tt>,
|
||||||
<tt>upperalpha</tt>,
|
<tt>upperalpha</tt>,
|
||||||
<tt>loweralpha</tt>,
|
<tt>loweralpha</tt>,
|
||||||
<tt>upperroman</tt>,
|
<tt>upperroman</tt>,
|
||||||
<tt>lowerroman</tt>.
|
<tt>lowerroman</tt>.
|
||||||
</p></dd><dt><a name="id2926582"></a><span class="term"> <tt><variablelist></tt></span></dt><dd><p><a name="id2926600"></a> This list is used when each entry is
|
</p></dd><dt><a name="id2937607"></a><span class="term"> <tt><variablelist></tt></span></dt><dd><p><a name="id2937625"></a> This list is used when each entry is
|
||||||
rather long, so it should be formatted as a block of text
|
rather long, so it should be formatted as a block of text
|
||||||
with some subtitle, like a small subsection. The
|
with some subtitle, like a small subsection. The
|
||||||
<tt><variablelist></tt> is more complicated
|
<tt><variablelist></tt> is more complicated
|
||||||
@ -331,25 +331,25 @@ make: *** No rule to make target `love'. Stop.
|
|||||||
are smart enough to change the numeration (for
|
are smart enough to change the numeration (for
|
||||||
<tt><orderedlist></tt>) or marks of each entry
|
<tt><orderedlist></tt>) or marks of each entry
|
||||||
(in <tt><itemizedlist></tt>) for sub-lists
|
(in <tt><itemizedlist></tt>) for sub-lists
|
||||||
</p></div></div><div class="sect2"><a name="inline"></a><div class="titlepage"><div><h3 class="title"><a name="inline"></a>Inline Elements</h3></div></div><div class="sect3"><a name="gui"></a><div class="titlepage"><div><h4 class="title"><a name="gui"></a>GUI elements</h4></div></div><div class="itemizedlist"><ul><li><p><a name="id2926761"></a>
|
</p></div></div><div class="sect2"><a name="inline"></a><div class="titlepage"><div><h3 class="title"><a name="inline"></a>Inline Elements</h3></div></div><div class="sect3"><a name="gui"></a><div class="titlepage"><div><h4 class="title"><a name="gui"></a>GUI elements</h4></div></div><div class="itemizedlist"><ul><li><p><a name="id2937796"></a>
|
||||||
<tt><guibutton></tt> -- used for
|
<tt><guibutton></tt> -- used for
|
||||||
buttons, including checkbuttons and radio buttons
|
buttons, including checkbuttons and radio buttons
|
||||||
</p></li><li><p><a name="id2926786"></a>
|
</p></li><li><p><a name="id2937822"></a>
|
||||||
<tt><guimenu></tt>,
|
<tt><guimenu></tt>,
|
||||||
<tt><guisubmenu></tt> --used for
|
<tt><guisubmenu></tt> --used for
|
||||||
top-level menus and submenus
|
top-level menus and submenus
|
||||||
respectively, for example <tt>
|
respectively, for example <tt>
|
||||||
<guisubmenu>Utilities</guisubmenu> submenu of the
|
<guisubmenu>Utilities</guisubmenu> submenu of the
|
||||||
<guimenu>Main Menu</guimenu></tt>
|
<guimenu>Main Menu</guimenu></tt>
|
||||||
</p></li><li><p><a name="id2926837"></a>
|
</p></li><li><p><a name="id2937872"></a>
|
||||||
<tt><guimenuitem></tt>--an entry in a
|
<tt><guimenuitem></tt>--an entry in a
|
||||||
menu
|
menu
|
||||||
</p></li><li><p><a name="id2926860"></a>
|
</p></li><li><p><a name="id2937896"></a>
|
||||||
<tt><guiicon></tt>--an icon
|
<tt><guiicon></tt>--an icon
|
||||||
</p></li><li><p><a name="id2926885"></a>
|
</p></li><li><p><a name="id2937921"></a>
|
||||||
<tt><guilabel></tt>--for items which have
|
<tt><guilabel></tt>--for items which have
|
||||||
labels, like tabs, or bounding boxes.
|
labels, like tabs, or bounding boxes.
|
||||||
</p></li><li><p><a name="id2926910"></a>
|
</p></li><li><p><a name="id2937946"></a>
|
||||||
<tt><interface></tt>-- for most everything
|
<tt><interface></tt>-- for most everything
|
||||||
else... a window, a dialog box, the Panel, etc.
|
else... a window, a dialog box, the Panel, etc.
|
||||||
</p></li></ul></div><p>
|
</p></li></ul></div><p>
|
||||||
@ -371,8 +371,8 @@ make: *** No rule to make target `love'. Stop.
|
|||||||
to (section, figure, etc.), while the second just creates a
|
to (section, figure, etc.), while the second just creates a
|
||||||
link (in HTML output). Here is an example:
|
link (in HTML output). Here is an example:
|
||||||
<pre class="programlisting">
|
<pre class="programlisting">
|
||||||
An example of a <link linkend="extip">tip</link> was given in
|
An example of a <link linkend="extip">tip</link> was given in
|
||||||
<xref linkend="notes" />.
|
<xref linkend="notes" />.
|
||||||
</pre>
|
</pre>
|
||||||
which produces: An example of a <a href="indexs04.html#extip">tip</a> was given in <a href="indexs04.html#notes" title="Notes, Warnings, And Tips">the section called “Notes, Warnings, And Tips”</a>.
|
which produces: An example of a <a href="indexs04.html#extip">tip</a> was given in <a href="indexs04.html#notes" title="Notes, Warnings, And Tips">the section called “Notes, Warnings, And Tips”</a>.
|
||||||
</p><p>
|
</p><p>
|
||||||
@ -383,8 +383,8 @@ An example of a <link linkend="extip">tip</link> was given
|
|||||||
Web page or a local file, use <tt><ulink></tt>
|
Web page or a local file, use <tt><ulink></tt>
|
||||||
tag, for example:
|
tag, for example:
|
||||||
<pre class="programlisting">
|
<pre class="programlisting">
|
||||||
To find more about GNOME, please visit <ulink type="http"
|
To find more about GNOME, please visit <ulink type="http"
|
||||||
url="http://www.gnome.org">GNOME Web page</ulink>
|
url="http://www.gnome.org">GNOME Web page</ulink>
|
||||||
</pre>
|
</pre>
|
||||||
which produces: To find more about GNOME, please visit
|
which produces: To find more about GNOME, please visit
|
||||||
<a href="http://www.gnome.org" target="_top">The GNOME Web
|
<a href="http://www.gnome.org" target="_top">The GNOME Web
|
||||||
@ -397,35 +397,35 @@ url="http://www.gnome.org">GNOME Web page</ulink>
|
|||||||
computer-related things</h4></div></div><p>
|
computer-related things</h4></div></div><p>
|
||||||
Here are some tags used to describe operating system-related
|
Here are some tags used to describe operating system-related
|
||||||
things:
|
things:
|
||||||
</p><div class="itemizedlist"><ul><li><p><a name="id2927306"></a> <tt><filename></tt> -- used
|
</p><div class="itemizedlist"><ul><li><p><a name="id2938334"></a> <tt><filename></tt> -- used
|
||||||
for filenames,
|
for filenames,
|
||||||
e.g.<tt><filename></tt>
|
e.g.<tt><filename></tt>
|
||||||
foo.sgml
|
foo.sgml
|
||||||
<tt></filename></tt>
|
<tt></filename></tt>
|
||||||
produces: <tt>foo.sgml</tt>.
|
produces: <tt>foo.sgml</tt>.
|
||||||
</p></li><li><p><a name="id2927360"></a> <tt><filename
|
</p></li><li><p><a name="id2938391"></a> <tt><filename
|
||||||
class="directory"></tt> -- used for
|
class="directory"></tt> -- used for
|
||||||
directories, e.g.<tt><filename
|
directories, e.g.<tt><filename
|
||||||
class="directory"></tt>/usr/bin
|
class="directory"></tt>/usr/bin
|
||||||
<tt></filename></tt>
|
<tt></filename></tt>
|
||||||
produces: <tt>/usr/bin</tt>.
|
produces: <tt>/usr/bin</tt>.
|
||||||
</p></li><li><p><a name="id2927420"></a>
|
</p></li><li><p><a name="id2938454"></a>
|
||||||
<tt><application></tt> -- used for
|
<tt><application></tt> -- used for
|
||||||
application names,
|
application names,
|
||||||
e.g. <tt><application></tt>Gnumeric
|
e.g. <tt><application></tt>Gnumeric
|
||||||
<tt></application></tt> produces:
|
<tt></application></tt> produces:
|
||||||
Gnumeric.
|
Gnumeric.
|
||||||
</p></li><li><p><a name="id2927475"></a>
|
</p></li><li><p><a name="id2938509"></a>
|
||||||
<tt><envar></tt> -- used for
|
<tt><envar></tt> -- used for
|
||||||
environment variables, e.g.
|
environment variables, e.g.
|
||||||
<tt><envar></tt>PATH<tt></envar></tt>.
|
<tt><envar></tt>PATH<tt></envar></tt>.
|
||||||
</p></li><li><p><a name="id2927515"></a>
|
</p></li><li><p><a name="id2938551"></a>
|
||||||
<tt><command></tt> -- used for
|
<tt><command></tt> -- used for
|
||||||
commands entered on command line, e.g.
|
commands entered on command line, e.g.
|
||||||
<tt><command></tt>make install
|
<tt><command></tt>make install
|
||||||
<tt></command></tt> produces:
|
<tt></command></tt> produces:
|
||||||
<b>make install</b>.
|
<b>make install</b>.
|
||||||
</p></li><li><p><a name="id2927571"></a>
|
</p></li><li><p><a name="id2938607"></a>
|
||||||
<tt><replaceable></tt> -- used for
|
<tt><replaceable></tt> -- used for
|
||||||
replaceable text, e.g.
|
replaceable text, e.g.
|
||||||
<tt><command></tt>db2html<tt><replaceable></tt>
|
<tt><command></tt>db2html<tt><replaceable></tt>
|
||||||
@ -493,15 +493,15 @@ url="http://www.gnome.org">GNOME Web page</ulink>
|
|||||||
is required.
|
is required.
|
||||||
</p><p>
|
</p><p>
|
||||||
here is partial list of most commonly used enitites:
|
here is partial list of most commonly used enitites:
|
||||||
</p><div class="itemizedlist"><ul><li><p><a name="id2928042"></a>
|
</p><div class="itemizedlist"><ul><li><p><a name="id2939068"></a>
|
||||||
<tt>&amp;</tt> -- ampersend (&)
|
<tt>&amp;</tt> -- ampersend (&)
|
||||||
</p></li><li><p><a name="id2928061"></a>
|
</p></li><li><p><a name="id2939089"></a>
|
||||||
<tt>&lt;</tt> -- left angle bracket (<)
|
<tt>&lt;</tt> -- left angle bracket (<)
|
||||||
</p></li><li><p><a name="id2928080"></a>
|
</p></li><li><p><a name="id2939108"></a>
|
||||||
<tt>&copy;</tt> -- copyright sign (<28>)
|
<tt>&copy;</tt> -- copyright sign (<28>)
|
||||||
</p></li><li><p><a name="id2928099"></a>
|
</p></li><li><p><a name="id2939126"></a>
|
||||||
<tt>&mdash;</tt> -- long dash (--)
|
<tt>&mdash;</tt> -- long dash (--)
|
||||||
</p></li><li><p><a name="id2928120"></a>
|
</p></li><li><p><a name="id2939152"></a>
|
||||||
<tt>&hellip;</tt> -- ellipsis (...)
|
<tt>&hellip;</tt> -- ellipsis (...)
|
||||||
</p></li></ul></div><p>
|
</p></li></ul></div><p>
|
||||||
Note that the actual look of the resulting symbols depends
|
Note that the actual look of the resulting symbols depends
|
||||||
|
|||||||
@ -13,7 +13,7 @@
|
|||||||
application for which the documentation is written:
|
application for which the documentation is written:
|
||||||
<pre class="programlisting">
|
<pre class="programlisting">
|
||||||
|
|
||||||
<sect1 id="intro">
|
<sect1 id="intro">
|
||||||
<title>Introduction</title>
|
<title>Introduction</title>
|
||||||
<para>
|
<para>
|
||||||
blah-blah-blah This document describes version 1.0.53 of gfoo.
|
blah-blah-blah This document describes version 1.0.53 of gfoo.
|
||||||
@ -31,7 +31,7 @@
|
|||||||
</p></div><div class="sect3"><a name="license2"></a><div class="titlepage"><div><h4 class="title"><a name="license2"></a>Software license</h4></div></div><p>
|
</p></div><div class="sect3"><a name="license2"></a><div class="titlepage"><div><h4 class="title"><a name="license2"></a>Software license</h4></div></div><p>
|
||||||
All GNOME applications must contain information about the
|
All GNOME applications must contain information about the
|
||||||
license (for software, not for documentation), either in the
|
license (for software, not for documentation), either in the
|
||||||
"About" box or in the manual.
|
"About" box or in the manual.
|
||||||
</p></div><div class="sect3"><a name="bugtraq"></a><div class="titlepage"><div><h4 class="title"><a name="bugtraq"></a> Bug reporting</h4></div></div><p>
|
</p></div><div class="sect3"><a name="bugtraq"></a><div class="titlepage"><div><h4 class="title"><a name="bugtraq"></a> Bug reporting</h4></div></div><p>
|
||||||
Application documentation should give an address for
|
Application documentation should give an address for
|
||||||
reporting bugs and for submitting comments about the
|
reporting bugs and for submitting comments about the
|
||||||
|
|||||||
@ -6,7 +6,7 @@
|
|||||||
each window or panel presented to the user using screenshots (in
|
each window or panel presented to the user using screenshots (in
|
||||||
PNG format only) when appropriate. They should also describe
|
PNG format only) when appropriate. They should also describe
|
||||||
each feature and preference option available.
|
each feature and preference option available.
|
||||||
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2928565"></a>Documentation Availability</h3><p>
|
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2939595"></a>Documentation Availability</h3><p>
|
||||||
Applications and applets should not rely on documentation
|
Applications and applets should not rely on documentation
|
||||||
which is only available on the internet. All manuals and
|
which is only available on the internet. All manuals and
|
||||||
other documentation should be packaged with the application or
|
other documentation should be packaged with the application or
|
||||||
@ -17,14 +17,14 @@
|
|||||||
the templates in <a href="apas02.html" title="Template 2: Applet Manual For GNOME 1.x">the section called “Template 2: Applet Manual For GNOME 1.x”</a> for GNOME
|
the templates in <a href="apas02.html" title="Template 2: Applet Manual For GNOME 1.x">the section called “Template 2: Applet Manual For GNOME 1.x”</a> for GNOME
|
||||||
versions 1.x and the templates in <a href="apas03.html" title="Template 2: Applet Manual For GNOME 2.x">the section called “Template 2: Applet Manual For GNOME 2.x”</a>
|
versions 1.x and the templates in <a href="apas03.html" title="Template 2: Applet Manual For GNOME 2.x">the section called “Template 2: Applet Manual For GNOME 2.x”</a>
|
||||||
for GNOME versions 2.x.
|
for GNOME versions 2.x.
|
||||||
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2928657"></a>Manuals For Large Applications</h3><p>
|
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2939689"></a>Manuals For Large Applications</h3><p>
|
||||||
Manuals for very large applications, such as GNOME Workshop
|
Manuals for very large applications, such as GNOME Workshop
|
||||||
components should be a <tt><book></tt> (and thus
|
components should be a <tt><book></tt> (and thus
|
||||||
use <tt><chapter></tt> for each primary section)
|
use <tt><chapter></tt> for each primary section)
|
||||||
, instead of <tt><article></tt> which most
|
, instead of <tt><article></tt> which most
|
||||||
applications use(with each primary section being a
|
applications use(with each primary section being a
|
||||||
<tt><sect1></tt>).
|
<tt><sect1></tt>).
|
||||||
</p></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2928715"></a>Applet Manuals in GNOME 2.0</h3><p>
|
</p></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2939746"></a>Applet Manuals in GNOME 2.0</h3><p>
|
||||||
Note that applet manuals in GNOME 2.0 are treated in a special
|
Note that applet manuals in GNOME 2.0 are treated in a special
|
||||||
way. The manuals for all applets are merged into a single
|
way. The manuals for all applets are merged into a single
|
||||||
virtual document by Nautilus. For this reason, the header
|
virtual document by Nautilus. For this reason, the header
|
||||||
@ -35,7 +35,7 @@
|
|||||||
<tt><sect2></tt>.
|
<tt><sect2></tt>.
|
||||||
</p></div><p>
|
</p></div><p>
|
||||||
Application manuals should be made available by having a
|
Application manuals should be made available by having a
|
||||||
"Manual" entry in the Help pull-down menu
|
"Manual" entry in the Help pull-down menu
|
||||||
at the top of the
|
at the top of the
|
||||||
application, as described in <a href="indexs07.html" title="Listing Documents in the Help Menu">the section called “Listing Documents in the Help Menu”</a>.
|
application, as described in <a href="indexs07.html" title="Listing Documents in the Help Menu">the section called “Listing Documents in the Help Menu”</a>.
|
||||||
Applets should make their manuals available by
|
Applets should make their manuals available by
|
||||||
|
|||||||
@ -1,4 +1,4 @@
|
|||||||
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Listing Documents in the Help Menu</title><meta name="generator" content="DocBook XSL Stylesheets V1.40"><link rel="home" href="index.html" title="The GNOME Handbook of Writing Software Documentation"><link rel="up" href="index.html" title="The GNOME Handbook of Writing Software Documentation"><link rel="previous" href="indexs06.html" title="Writing Application and Applet Manuals"><link rel="next" href="indexs08.html" title="Application Help Buttons"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Listing Documents in the Help Menu</th></tr><tr><td width="20%" align="left"><a href="indexs06.html">Prev</a><3E></td><th width="60%" align="center"><3E></th><td width="20%" align="right"><3E><a href="indexs08.html">Next</a></td></tr></table><hr></div><div class="sect1"><a name="listingdocsinhelpmenu"></a><div class="titlepage"><div><h2 class="title" style="clear: both"><a name="listingdocsinhelpmenu"></a>Listing Documents in the Help Menu</h2></div></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2928836"></a>Developer Information</h3><p>
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Listing Documents in the Help Menu</title><meta name="generator" content="DocBook XSL Stylesheets V1.40"><link rel="home" href="index.html" title="The GNOME Handbook of Writing Software Documentation"><link rel="up" href="index.html" title="The GNOME Handbook of Writing Software Documentation"><link rel="previous" href="indexs06.html" title="Writing Application and Applet Manuals"><link rel="next" href="indexs08.html" title="Application Help Buttons"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Listing Documents in the Help Menu</th></tr><tr><td width="20%" align="left"><a href="indexs06.html">Prev</a><3E></td><th width="60%" align="center"><3E></th><td width="20%" align="right"><3E><a href="indexs08.html">Next</a></td></tr></table><hr></div><div class="sect1"><a name="listingdocsinhelpmenu"></a><div class="titlepage"><div><h2 class="title" style="clear: both"><a name="listingdocsinhelpmenu"></a>Listing Documents in the Help Menu</h2></div></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2939869"></a>Developer Information</h3><p>
|
||||||
This section is for developers. Documentation authors
|
This section is for developers. Documentation authors
|
||||||
generally do not need to know this material.
|
generally do not need to know this material.
|
||||||
</p></div><p>
|
</p></div><p>
|
||||||
@ -30,7 +30,7 @@ function-reference.html Gnumeric function reference
|
|||||||
application's name. The application documentation (converted
|
application's name. The application documentation (converted
|
||||||
from SGML into HTML with <b>db2html</b>) should be
|
from SGML into HTML with <b>db2html</b>) should be
|
||||||
placed in this directory too.
|
placed in this directory too.
|
||||||
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2929024"></a>Note</h3><p>
|
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2940058"></a>Note</h3><p>
|
||||||
If the help files are not present in the correct directory, the
|
If the help files are not present in the correct directory, the
|
||||||
menu items will NOT appear when the program is run.
|
menu items will NOT appear when the program is run.
|
||||||
</p></div><p>
|
</p></div><p>
|
||||||
@ -40,12 +40,12 @@ function-reference.html Gnumeric function reference
|
|||||||
<pre class="programlisting">
|
<pre class="programlisting">
|
||||||
GnomeUIInfo helpmenu[] = {
|
GnomeUIInfo helpmenu[] = {
|
||||||
{GNOME_APP_UI_ITEM,
|
{GNOME_APP_UI_ITEM,
|
||||||
N_("About"), N_("Info about this program"),
|
N_("About"), N_("Info about this program"),
|
||||||
about_cb, NULL, NULL,
|
about_cb, NULL, NULL,
|
||||||
GNOME_APP_PIXMAP_STOCK, GNOME_STOCK_MENU_ABOUT,
|
GNOME_APP_PIXMAP_STOCK, GNOME_STOCK_MENU_ABOUT,
|
||||||
0, 0, NULL},
|
0, 0, NULL},
|
||||||
GNOMEUIINFO_SEPARATOR,
|
GNOMEUIINFO_SEPARATOR,
|
||||||
GNOMEUIINFO_HELP("<i>appname</i>"),
|
GNOMEUIINFO_HELP("<i>appname</i>"),
|
||||||
GNOMEUIINFO_END
|
GNOMEUIINFO_END
|
||||||
};
|
};
|
||||||
</pre>
|
</pre>
|
||||||
|
|||||||
@ -1,4 +1,4 @@
|
|||||||
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Application Help Buttons</title><meta name="generator" content="DocBook XSL Stylesheets V1.40"><link rel="home" href="index.html" title="The GNOME Handbook of Writing Software Documentation"><link rel="up" href="index.html" title="The GNOME Handbook of Writing Software Documentation"><link rel="previous" href="indexs07.html" title="Listing Documents in the Help Menu"><link rel="next" href="indexs09.html" title="Packaging Applet Documentation"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Application Help Buttons</th></tr><tr><td width="20%" align="left"><a href="indexs07.html">Prev</a><3E></td><th width="60%" align="center"><3E></th><td width="20%" align="right"><3E><a href="indexs09.html">Next</a></td></tr></table><hr></div><div class="sect1"><a name="applicationhelpbuttons"></a><div class="titlepage"><div><h2 class="title" style="clear: both"><a name="applicationhelpbuttons"></a>Application Help Buttons</h2></div></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2929190"></a>Developer Information</h3><p>
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Application Help Buttons</title><meta name="generator" content="DocBook XSL Stylesheets V1.40"><link rel="home" href="index.html" title="The GNOME Handbook of Writing Software Documentation"><link rel="up" href="index.html" title="The GNOME Handbook of Writing Software Documentation"><link rel="previous" href="indexs07.html" title="Listing Documents in the Help Menu"><link rel="next" href="indexs09.html" title="Packaging Applet Documentation"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Application Help Buttons</th></tr><tr><td width="20%" align="left"><a href="indexs07.html">Prev</a><3E></td><th width="60%" align="center"><3E></th><td width="20%" align="right"><3E><a href="indexs09.html">Next</a></td></tr></table><hr></div><div class="sect1"><a name="applicationhelpbuttons"></a><div class="titlepage"><div><h2 class="title" style="clear: both"><a name="applicationhelpbuttons"></a>Application Help Buttons</h2></div></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2940222"></a>Developer Information</h3><p>
|
||||||
This section is for developers. Documentation authors
|
This section is for developers. Documentation authors
|
||||||
generally do not need to know this material.
|
generally do not need to know this material.
|
||||||
</p></div><p>
|
</p></div><p>
|
||||||
@ -18,12 +18,12 @@
|
|||||||
Browser the developer should add code based on the following example:
|
Browser the developer should add code based on the following example:
|
||||||
</p><pre class="programlisting">
|
</p><pre class="programlisting">
|
||||||
gchar *tmp;
|
gchar *tmp;
|
||||||
tmp = gnome_help_file_find_file ("module", "page.html");
|
tmp = gnome_help_file_find_file ("module", "page.html");
|
||||||
if (tmp) {
|
if (tmp) {
|
||||||
gnome_help_goto(0, tmp);
|
gnome_help_goto(0, tmp);
|
||||||
g_free(tmp);
|
g_free(tmp);
|
||||||
}
|
}
|
||||||
</pre><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2929326"></a>NOTE</h3><p>
|
</pre><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2940360"></a>NOTE</h3><p>
|
||||||
The example above is in the C language, please refer to other
|
The example above is in the C language, please refer to other
|
||||||
documentation or forums for other GNOME language bindings.
|
documentation or forums for other GNOME language bindings.
|
||||||
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a href="indexs07.html">Prev</a><3E></td><td width="20%" align="center"><a href="index.html">Home</a></td><td width="40%" align="right"><3E><a href="indexs09.html">Next</a></td></tr><tr><td width="40%" align="left">Listing Documents in the Help Menu<6E></td><td width="20%" align="center"><a href="index.html">Up</a></td><td width="40%" align="right"><3E>Packaging Applet Documentation</td></tr></table></div></body></html>
|
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a href="indexs07.html">Prev</a><3E></td><td width="20%" align="center"><a href="index.html">Home</a></td><td width="40%" align="right"><3E><a href="indexs09.html">Next</a></td></tr><tr><td width="40%" align="left">Listing Documents in the Help Menu<6E></td><td width="20%" align="center"><a href="index.html">Up</a></td><td width="40%" align="right"><3E>Packaging Applet Documentation</td></tr></table></div></body></html>
|
||||||
|
|||||||
@ -32,7 +32,7 @@
|
|||||||
of the <i>GNOME Applets</i> book, you must
|
of the <i>GNOME Applets</i> book, you must
|
||||||
remember to add <tt><legalnotice></tt> and
|
remember to add <tt><legalnotice></tt> and
|
||||||
<tt><copyright></tt> sections.
|
<tt><copyright></tt> sections.
|
||||||
</p></div><div class="sect2"><a name="appletmenu"></a><div class="titlepage"><div><h3 class="title"><a name="appletmenu"></a>Adding Documentation to an Applet Menu</h3></div></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2929573"></a>Developer Information</h3><p>
|
</p></div><div class="sect2"><a name="appletmenu"></a><div class="titlepage"><div><h3 class="title"><a name="appletmenu"></a>Adding Documentation to an Applet Menu</h3></div></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title"><a name="id2940608"></a>Developer Information</h3><p>
|
||||||
This section is for developers. Documentation authors
|
This section is for developers. Documentation authors
|
||||||
generally do not need to know this material.
|
generally do not need to know this material.
|
||||||
</p></div><p>
|
</p></div><p>
|
||||||
@ -45,8 +45,8 @@
|
|||||||
To add an applet's manual to its applet menu, use:
|
To add an applet's manual to its applet menu, use:
|
||||||
<pre class="programlisting">
|
<pre class="programlisting">
|
||||||
/* add an item to the applet menu */
|
/* add an item to the applet menu */
|
||||||
applet_widget_register_callback(APPLET_WIDGET(applet), "manual",
|
applet_widget_register_callback(APPLET_WIDGET(applet), "manual",
|
||||||
_("Manual"), &open_manual, NULL);
|
_("Manual"), &open_manual, NULL);
|
||||||
</pre>
|
</pre>
|
||||||
Here the second argument is an arbitrary name for the
|
Here the second argument is an arbitrary name for the
|
||||||
callback, the third argument is the label which will appear
|
callback, the third argument is the label which will appear
|
||||||
@ -62,8 +62,8 @@ _("Manual"), &open_manual, NULL);
|
|||||||
item to the applet's menu. This is a
|
item to the applet's menu. This is a
|
||||||
stock menu item and is done:
|
stock menu item and is done:
|
||||||
<pre class="programlisting">
|
<pre class="programlisting">
|
||||||
applet_widget_register_stock_callback (APPLET_WIDGET(applet), "about",
|
applet_widget_register_stock_callback (APPLET_WIDGET(applet), "about",
|
||||||
GNOME_STOCK_MENU_ABOUT, _("About"), &my_applet_cb_about,
|
GNOME_STOCK_MENU_ABOUT, _("About"), &my_applet_cb_about,
|
||||||
NULL);
|
NULL);
|
||||||
</pre>
|
</pre>
|
||||||
</p><p>
|
</p><p>
|
||||||
|
|||||||
@ -1,6 +1,6 @@
|
|||||||
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Writing Context Sensitive Help (coming in GNOME-2.0)</title><meta name="generator" content="DocBook XSL Stylesheets V1.40"><link rel="home" href="index.html" title="The GNOME Handbook of Writing Software Documentation"><link rel="up" href="index.html" title="The GNOME Handbook of Writing Software Documentation"><link rel="previous" href="indexs09.html" title="Packaging Applet Documentation"><link rel="next" href="indexs11.html" title="Referring to Other GNOME Documentation (coming in
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Writing Context Sensitive Help (coming in GNOME-2.0)</title><meta name="generator" content="DocBook XSL Stylesheets V1.40"><link rel="home" href="index.html" title="The GNOME Handbook of Writing Software Documentation"><link rel="up" href="index.html" title="The GNOME Handbook of Writing Software Documentation"><link rel="previous" href="indexs09.html" title="Packaging Applet Documentation"><link rel="next" href="indexs11.html" title="Referring to Other GNOME Documentation (coming in
|
||||||
GNOME-2.0)"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Writing Context Sensitive Help (coming in GNOME-2.0)</th></tr><tr><td width="20%" align="left"><a href="indexs09.html">Prev</a><3E></td><th width="60%" align="center"><3E></th><td width="20%" align="right"><3E><a href="indexs11.html">Next</a></td></tr></table><hr></div><div class="sect1"><a name="writingcontextsensitivehelp"></a><div class="titlepage"><div><h2 class="title" style="clear: both"><a name="writingcontextsensitivehelp"></a>Writing Context Sensitive Help (coming in GNOME-2.0)</h2></div></div><p>
|
GNOME-2.0)"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Writing Context Sensitive Help (coming in GNOME-2.0)</th></tr><tr><td width="20%" align="left"><a href="indexs09.html">Prev</a><3E></td><th width="60%" align="center"><3E></th><td width="20%" align="right"><3E><a href="indexs11.html">Next</a></td></tr></table><hr></div><div class="sect1"><a name="writingcontextsensitivehelp"></a><div class="titlepage"><div><h2 class="title" style="clear: both"><a name="writingcontextsensitivehelp"></a>Writing Context Sensitive Help (coming in GNOME-2.0)</h2></div></div><p>
|
||||||
Context sensitive help, also known as "pop-up" help, will allow
|
Context sensitive help, also known as "pop-up" help, will allow
|
||||||
a user to obtain help information about specific buttons or
|
a user to obtain help information about specific buttons or
|
||||||
parts of an application.
|
parts of an application.
|
||||||
</p><p>
|
</p><p>
|
||||||
@ -13,7 +13,7 @@
|
|||||||
developer to give an id to a particular portion of the User
|
developer to give an id to a particular portion of the User
|
||||||
Interface, for example, a button. Once the interface is complete
|
Interface, for example, a button. Once the interface is complete
|
||||||
a Perl script can then be run against the interface code to
|
a Perl script can then be run against the interface code to
|
||||||
create a "map" file. This map file allows the developer or
|
create a "map" file. This map file allows the developer or
|
||||||
writer to associate particular paragraph sections from an XML
|
writer to associate particular paragraph sections from an XML
|
||||||
document to the interface items.
|
document to the interface items.
|
||||||
</p><p>
|
</p><p>
|
||||||
@ -25,7 +25,7 @@
|
|||||||
user launches context sensitive help on the interface (either by
|
user launches context sensitive help on the interface (either by
|
||||||
pressing a button and then clicking on the interface item they
|
pressing a button and then clicking on the interface item they
|
||||||
want information on, or by right mouse clicking on the interface
|
want information on, or by right mouse clicking on the interface
|
||||||
item and selecting a pop-up menu item like "What's This") a
|
item and selecting a pop-up menu item like "What's This") a
|
||||||
small transient window will appear with brief but detailed
|
small transient window will appear with brief but detailed
|
||||||
information on the interface item.
|
information on the interface item.
|
||||||
</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a href="indexs09.html">Prev</a><3E></td><td width="20%" align="center"><a href="index.html">Home</a></td><td width="40%" align="right"><3E><a href="indexs11.html">Next</a></td></tr><tr><td width="40%" align="left">Packaging Applet Documentation<6F></td><td width="20%" align="center"><a href="index.html">Up</a></td><td width="40%" align="right"><3E>Referring to Other GNOME Documentation (coming in
|
</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a href="indexs09.html">Prev</a><3E></td><td width="20%" align="center"><a href="index.html">Home</a></td><td width="40%" align="right"><3E><a href="indexs11.html">Next</a></td></tr><tr><td width="40%" align="left">Packaging Applet Documentation<6F></td><td width="20%" align="center"><a href="index.html">Up</a></td><td width="40%" align="right"><3E>Referring to Other GNOME Documentation (coming in
|
||||||
|
|||||||
@ -33,7 +33,7 @@
|
|||||||
</p></div><div class="sect2"><a name="balance"></a><div class="titlepage"><div><h3 class="title"><a name="balance"></a>Achieving a Balanced Style</h3></div></div><p>
|
</p></div><div class="sect2"><a name="balance"></a><div class="titlepage"><div><h3 class="title"><a name="balance"></a>Achieving a Balanced Style</h3></div></div><p>
|
||||||
Just as you need to juggle expert and novice readers,
|
Just as you need to juggle expert and novice readers,
|
||||||
you'll have to juggle a number of other extremes as you write:
|
you'll have to juggle a number of other extremes as you write:
|
||||||
<div class="itemizedlist"><ul><li><p><a name="id2930118"></a>
|
<div class="itemizedlist"><ul><li><p><a name="id2941166"></a>
|
||||||
Documents should be complete, yet concise. You should
|
Documents should be complete, yet concise. You should
|
||||||
describe every feature, but you'll have decide how much
|
describe every feature, but you'll have decide how much
|
||||||
detail is really necessary. It's not, for example,
|
detail is really necessary. It's not, for example,
|
||||||
@ -43,7 +43,7 @@
|
|||||||
you spend fewer words on the obvious, you can spend more
|
you spend fewer words on the obvious, you can spend more
|
||||||
time clarifying the ambiguous labels and explaining
|
time clarifying the ambiguous labels and explaining
|
||||||
items that are more complex.
|
items that are more complex.
|
||||||
</p></li><li><p><a name="id2930146"></a>
|
</p></li><li><p><a name="id2941193"></a>
|
||||||
Be engaging and friendly, yet professional. Games
|
Be engaging and friendly, yet professional. Games
|
||||||
documents may be less formal than productivity
|
documents may be less formal than productivity
|
||||||
application documents (people don't
|
application documents (people don't
|
||||||
@ -52,14 +52,14 @@
|
|||||||
maintain a standard of style which holds the reader's
|
maintain a standard of style which holds the reader's
|
||||||
interest without resorting to jokes and untranslatable
|
interest without resorting to jokes and untranslatable
|
||||||
allusions or puns.
|
allusions or puns.
|
||||||
</p></li><li><p><a name="id2930185"></a>
|
</p></li><li><p><a name="id2941232"></a>
|
||||||
Examples, tips, notes, and screenshots are useful to
|
Examples, tips, notes, and screenshots are useful to
|
||||||
break up long stretches of text, but too many can get in
|
break up long stretches of text, but too many can get in
|
||||||
the way, and make your documents too choppy to read.
|
the way, and make your documents too choppy to read.
|
||||||
It's good to provide a screenshot of any dialog windows
|
It's good to provide a screenshot of any dialog windows
|
||||||
a user might run into, but if a dialog box has several
|
a user might run into, but if a dialog box has several
|
||||||
tabs, it's not usually necessary to have one for each.
|
tabs, it's not usually necessary to have one for each.
|
||||||
</p></li><li><p><a name="id2930208"></a>
|
</p></li><li><p><a name="id2941255"></a>
|
||||||
The GDP strives to have all of its documentation conform
|
The GDP strives to have all of its documentation conform
|
||||||
to certain standards of style and content, but every
|
to certain standards of style and content, but every
|
||||||
document (and every writer) is different. You will need
|
document (and every writer) is different. You will need
|
||||||
@ -101,7 +101,7 @@
|
|||||||
bug reports, writers must check for errors in their documents.
|
bug reports, writers must check for errors in their documents.
|
||||||
Poor grammar, bad spelling, and gross technical errors in
|
Poor grammar, bad spelling, and gross technical errors in
|
||||||
draft documents are fine. However, if those problems show up
|
draft documents are fine. However, if those problems show up
|
||||||
in a "real" release, they can count against the credibility of
|
in a "real" release, they can count against the credibility of
|
||||||
GNOME and Linux. They'll also make you look bad.
|
GNOME and Linux. They'll also make you look bad.
|
||||||
</p><p>
|
</p><p>
|
||||||
There is no substitute for a human proofreader; use a
|
There is no substitute for a human proofreader; use a
|
||||||
|
|||||||
@ -82,7 +82,7 @@ be contacted at <a href="mailto:cmsmcq@w3.org">cmsmcq@w3.org</a>.</p>
|
|||||||
<h2><a name="contents">Table of Contents</a></h2><p class="toc">1 <a href="#sec-intro">Introduction</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>1.1 <a href="#sec-origin-goals">Origin and Goals</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>1.2 <a href="#sec-terminology">Terminology</a><br>2 <a href="#sec-documents">Documents</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.1 <a href="#sec-well-formed">Well-Formed XML Documents</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.2 <a href="#charsets">Characters</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.3 <a href="#sec-common-syn">Common Syntactic Constructs</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.4 <a href="#syntax">Character Data and Markup</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.5 <a href="#sec-comments">Comments</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.6 <a href="#sec-pi">Processing Instructions</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.7 <a href="#sec-cdata-sect">CDATA Sections</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.8 <a href="#sec-prolog-dtd">Prolog and Document Type Declaration</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.9 <a href="#sec-rmd">Standalone Document Declaration</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.10 <a href="#sec-white-space">White Space Handling</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.11 <a href="#sec-line-ends">End-of-Line Handling</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.12 <a href="#sec-lang-tag">Language Identification</a><br>3 <a href="#sec-logical-struct">Logical Structures</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.1 <a href="#sec-starttags">Start-Tags, End-Tags, and Empty-Element Tags</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.2 <a href="#elemdecls">Element Type Declarations</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.2.1 <a href="#sec-element-content">Element Content</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.2.2 <a href="#sec-mixed-content">Mixed Content</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.3 <a href="#attdecls">Attribute-List Declarations</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.3.1 <a href="#sec-attribute-types">Attribute Types</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.3.2 <a href="#sec-attr-defaults">Attribute Defaults</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.3.3 <a href="#AVNormalize">Attribute-Value
|
<h2><a name="contents">Table of Contents</a></h2><p class="toc">1 <a href="#sec-intro">Introduction</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>1.1 <a href="#sec-origin-goals">Origin and Goals</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>1.2 <a href="#sec-terminology">Terminology</a><br>2 <a href="#sec-documents">Documents</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.1 <a href="#sec-well-formed">Well-Formed XML Documents</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.2 <a href="#charsets">Characters</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.3 <a href="#sec-common-syn">Common Syntactic Constructs</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.4 <a href="#syntax">Character Data and Markup</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.5 <a href="#sec-comments">Comments</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.6 <a href="#sec-pi">Processing Instructions</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.7 <a href="#sec-cdata-sect">CDATA Sections</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.8 <a href="#sec-prolog-dtd">Prolog and Document Type Declaration</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.9 <a href="#sec-rmd">Standalone Document Declaration</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.10 <a href="#sec-white-space">White Space Handling</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.11 <a href="#sec-line-ends">End-of-Line Handling</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.12 <a href="#sec-lang-tag">Language Identification</a><br>3 <a href="#sec-logical-struct">Logical Structures</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.1 <a href="#sec-starttags">Start-Tags, End-Tags, and Empty-Element Tags</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.2 <a href="#elemdecls">Element Type Declarations</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.2.1 <a href="#sec-element-content">Element Content</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.2.2 <a href="#sec-mixed-content">Mixed Content</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.3 <a href="#attdecls">Attribute-List Declarations</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.3.1 <a href="#sec-attribute-types">Attribute Types</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.3.2 <a href="#sec-attr-defaults">Attribute Defaults</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.3.3 <a href="#AVNormalize">Attribute-Value
|
||||||
Normalization</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.4 <a href="#sec-condition-sect">Conditional Sections</a><br>4 <a href="#sec-physical-struct">Physical Structures</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.1 <a href="#sec-references">Character and Entity References</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.2 <a href="#sec-entity-decl">Entity Declarations</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.2.1 <a href="#sec-internal-ent">Internal Entities</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.2.2 <a href="#sec-external-ent">External Entities</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.3 <a href="#TextEntities">Parsed Entities</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.3.1 <a href="#sec-TextDecl">The Text Declaration</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.3.2 <a href="#wf-entities">Well-Formed Parsed Entities</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.3.3 <a href="#charencoding">Character Encoding in Entities</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4 <a href="#entproc">XML Processor Treatment of Entities and References</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.1 <a href="#not-recognized">Not Recognized</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.2 <a href="#included">Included</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.3 <a href="#include-if-valid">Included If Validating</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.4 <a href="#forbidden">Forbidden</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.5 <a href="#inliteral">Included in Literal</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.6 <a href="#notify">Notify</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.7 <a href="#bypass">Bypassed</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.8 <a href="#as-PE">Included as PE</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.5 <a href="#intern-replacement">Construction of Internal Entity Replacement Text</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.6 <a href="#sec-predefined-ent">Predefined Entities</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.7 <a href="#Notations">Notation Declarations</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.8 <a href="#sec-doc-entity">Document Entity</a><br>5 <a href="#sec-conformance">Conformance</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>5.1 <a href="#proc-types">Validating and Non-Validating Processors</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>5.2 <a href="#safe-behavior">Using XML Processors</a><br>6 <a href="#sec-notation">Notation</a><br></p>
|
Normalization</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.4 <a href="#sec-condition-sect">Conditional Sections</a><br>4 <a href="#sec-physical-struct">Physical Structures</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.1 <a href="#sec-references">Character and Entity References</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.2 <a href="#sec-entity-decl">Entity Declarations</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.2.1 <a href="#sec-internal-ent">Internal Entities</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.2.2 <a href="#sec-external-ent">External Entities</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.3 <a href="#TextEntities">Parsed Entities</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.3.1 <a href="#sec-TextDecl">The Text Declaration</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.3.2 <a href="#wf-entities">Well-Formed Parsed Entities</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.3.3 <a href="#charencoding">Character Encoding in Entities</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4 <a href="#entproc">XML Processor Treatment of Entities and References</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.1 <a href="#not-recognized">Not Recognized</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.2 <a href="#included">Included</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.3 <a href="#include-if-valid">Included If Validating</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.4 <a href="#forbidden">Forbidden</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.5 <a href="#inliteral">Included in Literal</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.6 <a href="#notify">Notify</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.7 <a href="#bypass">Bypassed</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.8 <a href="#as-PE">Included as PE</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.5 <a href="#intern-replacement">Construction of Internal Entity Replacement Text</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.6 <a href="#sec-predefined-ent">Predefined Entities</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.7 <a href="#Notations">Notation Declarations</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.8 <a href="#sec-doc-entity">Document Entity</a><br>5 <a href="#sec-conformance">Conformance</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>5.1 <a href="#proc-types">Validating and Non-Validating Processors</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>5.2 <a href="#safe-behavior">Using XML Processors</a><br>6 <a href="#sec-notation">Notation</a><br></p>
|
||||||
<h3>Appendices</h3><p class="toc">A <a href="#sec-bibliography">References</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>A.1 <a href="#sec-existing-stds">Normative References</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>A.2 <a href="#null">Other References</a><br>B <a href="#CharClasses">Character Classes</a><br>C <a href="#sec-xml-and-sgml">XML and SGML</a> (Non-Normative)<br>D <a href="#sec-entexpand">Expansion of Entity and Character References</a> (Non-Normative)<br>E <a href="#determinism">Deterministic Content Models</a> (Non-Normative)<br>F <a href="#sec-guessing">Autodetection
|
<h3>Appendices</h3><p class="toc">A <a href="#sec-bibliography">References</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>A.1 <a href="#sec-existing-stds">Normative References</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>A.2 <a href="#null">Other References</a><br>B <a href="#CharClasses">Character Classes</a><br>C <a href="#sec-xml-and-sgml">XML and SGML</a> (Non-Normative)<br>D <a href="#sec-entexpand">Expansion of Entity and Character References</a> (Non-Normative)<br>E <a href="#determinism">Deterministic Content Models</a> (Non-Normative)<br>F <a href="#sec-guessing">Autodetection
|
||||||
of Character Encodings</a> (Non-Normative)<br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>F.1 <a href="#sec-guessing-no-ext-info">Detection Without External Encoding Information</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>F.2 <a href="#sec-guessing-with-ext-info">Priorities in the Presence of External Encoding Information</a><br>G <a href="#sec-xml-wg">W3C XML Working Group</a> (Non-Normative)<br>H <a href="#sec-core-wg">W3C XML Core Group</a> (Non-Normative)<br>I <a href="#id2676581">Production Notes</a> (Non-Normative)<br></p></div><hr><div class="body">
|
of Character Encodings</a> (Non-Normative)<br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>F.1 <a href="#sec-guessing-no-ext-info">Detection Without External Encoding Information</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>F.2 <a href="#sec-guessing-with-ext-info">Priorities in the Presence of External Encoding Information</a><br>G <a href="#sec-xml-wg">W3C XML Working Group</a> (Non-Normative)<br>H <a href="#sec-core-wg">W3C XML Core Group</a> (Non-Normative)<br>I <a href="#id2681697">Production Notes</a> (Non-Normative)<br></p></div><hr><div class="body">
|
||||||
<div class="div1">
|
<div class="div1">
|
||||||
|
|
||||||
<h2><a name="sec-intro"></a>1 Introduction</h2>
|
<h2><a name="sec-intro"></a>1 Introduction</h2>
|
||||||
@ -231,7 +231,7 @@ be <a title="Validity" href="#dt-valid">valid</a> if it meets certain further co
|
|||||||
<p>Each XML document has both a logical and a physical structure. Physically,
|
<p>Each XML document has both a logical and a physical structure. Physically,
|
||||||
the document is composed of units called <a title="Entity" href="#dt-entity">entities</a>.
|
the document is composed of units called <a title="Entity" href="#dt-entity">entities</a>.
|
||||||
An entity may <a title="Entity Reference" href="#dt-entref">refer</a> to other entities to
|
An entity may <a title="Entity Reference" href="#dt-entref">refer</a> to other entities to
|
||||||
cause their inclusion in the document. A document begins in a "root"
|
cause their inclusion in the document. A document begins in a "root"
|
||||||
or <a title="Document Entity" href="#dt-docent">document entity</a>. Logically, the document
|
or <a title="Document Entity" href="#dt-docent">document entity</a>. Logically, the document
|
||||||
is composed of declarations, elements, comments, character references, and
|
is composed of declarations, elements, comments, character references, and
|
||||||
processing instructions, all of which are indicated in the document by explicit
|
processing instructions, all of which are indicated in the document by explicit
|
||||||
@ -286,7 +286,7 @@ versions of these standards cited in <a href="#sec-existing-stds"><b>A.1 Normati
|
|||||||
current at the time this document was prepared. New characters may be added
|
current at the time this document was prepared. New characters may be added
|
||||||
to these standards by amendments or new editions. Consequently, XML processors
|
to these standards by amendments or new editions. Consequently, XML processors
|
||||||
must accept any character in the range specified for <a href="#NT-Char">Char</a>.</span>
|
must accept any character in the range specified for <a href="#NT-Char">Char</a>.</span>
|
||||||
The use of "compatibility characters", as defined in section
|
The use of "compatibility characters", as defined in section
|
||||||
6.8 of <a href="#Unicode">[Unicode]</a> <span class="diff-add"><a href="http://www.w3.org/XML/xml-19980210-errata#E67">[E67]</a>(see
|
6.8 of <a href="#Unicode">[Unicode]</a> <span class="diff-add"><a href="http://www.w3.org/XML/xml-19980210-errata#E67">[E67]</a>(see
|
||||||
also D21 in section 3.6 of <a href="#Unicode3">[Unicode3]</a>)</span>, is discouraged.]</p>
|
also D21 in section 3.6 of <a href="#Unicode3">[Unicode3]</a>)</span>, is discouraged.]</p>
|
||||||
|
|
||||||
@ -317,7 +317,7 @@ are given in <a href="#CharClasses"><b>B Character Classes</b></a>.</p>
|
|||||||
<p>[<a name="dt-name" title="Name">Definition</a>: A <b>Name</b> is a token beginning
|
<p>[<a name="dt-name" title="Name">Definition</a>: A <b>Name</b> is a token beginning
|
||||||
with a letter or one of a few punctuation characters, and continuing with
|
with a letter or one of a few punctuation characters, and continuing with
|
||||||
letters, digits, hyphens, underscores, colons, or full stops, together known
|
letters, digits, hyphens, underscores, colons, or full stops, together known
|
||||||
as name characters.] Names beginning with the string "<code>xml</code>",
|
as name characters.] Names beginning with the string "<code>xml</code>",
|
||||||
or any string which would match <code>(('X'|'x') ('M'|'m') ('L'|'l'))</code>,
|
or any string which would match <code>(('X'|'x') ('M'|'m') ('L'|'l'))</code>,
|
||||||
are reserved for standardization in this or future versions of this specification.</p>
|
are reserved for standardization in this or future versions of this specification.</p>
|
||||||
<div class="note"><p class="prefix"><b>Note:</b></p>
|
<div class="note"><p class="prefix"><b>Note:</b></p>
|
||||||
@ -339,16 +339,16 @@ of attributes (<a href="#NT-AttValue">AttValue</a>), and external identifiers
|
|||||||
(<a href="#NT-SystemLiteral">SystemLiteral</a>). Note that a <a href="#NT-SystemLiteral">SystemLiteral</a>
|
(<a href="#NT-SystemLiteral">SystemLiteral</a>). Note that a <a href="#NT-SystemLiteral">SystemLiteral</a>
|
||||||
can be parsed without scanning for markup.</p>
|
can be parsed without scanning for markup.</p>
|
||||||
|
|
||||||
<h5>Literals</h5><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td><a name="NT-EntityValue"></a>[9]<5D><><EFBFBD></td><td><code>EntityValue</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'"' ([^%&"] | <a href="#NT-PEReference">PEReference</a>
|
<h5>Literals</h5><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td><a name="NT-EntityValue"></a>[9]<5D><><EFBFBD></td><td><code>EntityValue</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'"' ([^%&"] | <a href="#NT-PEReference">PEReference</a>
|
||||||
| <a href="#NT-Reference">Reference</a>)* '"' </code></td><xsltdebug></xsltdebug></tr><tr valign="baseline"><td></td><td></td><td></td><td><code>|<7C> "'" ([^%&'] | <a href="#NT-PEReference">PEReference</a> | <a href="#NT-Reference">Reference</a>)* "'"</code></td></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-AttValue"></a>[10]<5D><><EFBFBD></td><td><code>AttValue</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'"' ([^<&"] | <a href="#NT-Reference">Reference</a>)*
|
| <a href="#NT-Reference">Reference</a>)* '"' </code></td><xsltdebug></xsltdebug></tr><tr valign="baseline"><td></td><td></td><td></td><td><code>|<7C> "'" ([^%&'] | <a href="#NT-PEReference">PEReference</a> | <a href="#NT-Reference">Reference</a>)* "'"</code></td></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-AttValue"></a>[10]<5D><><EFBFBD></td><td><code>AttValue</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'"' ([^<&"] | <a href="#NT-Reference">Reference</a>)*
|
||||||
'"' </code></td><xsltdebug></xsltdebug></tr><tr valign="baseline"><td></td><td></td><td></td><td><code>|<7C> "'" ([^<&'] | <a href="#NT-Reference">Reference</a>)*
|
'"' </code></td><xsltdebug></xsltdebug></tr><tr valign="baseline"><td></td><td></td><td></td><td><code>|<7C> "'" ([^<&'] | <a href="#NT-Reference">Reference</a>)*
|
||||||
"'"</code></td></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-SystemLiteral"></a>[11]<5D><><EFBFBD></td><td><code>SystemLiteral</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>('"' [^"]* '"') |<7C>("'" [^']* "'") </code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-PubidLiteral"></a>[12]<5D><><EFBFBD></td><td><code>PubidLiteral</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'"' <a href="#NT-PubidChar">PubidChar</a>* '"'
|
"'"</code></td></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-SystemLiteral"></a>[11]<5D><><EFBFBD></td><td><code>SystemLiteral</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>('"' [^"]* '"') |<7C>("'" [^']* "'") </code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-PubidLiteral"></a>[12]<5D><><EFBFBD></td><td><code>PubidLiteral</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'"' <a href="#NT-PubidChar">PubidChar</a>* '"'
|
||||||
| "'" (<a href="#NT-PubidChar">PubidChar</a> - "'")* "'"</code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-PubidChar"></a>[13]<5D><><EFBFBD></td><td><code>PubidChar</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>#x20 | #xD | #xA |<7C>[a-zA-Z0-9] |<7C>[-'()+,./:=?;!*#@$_%]</code></td><xsltdebug></xsltdebug></tr></tbody></table>
|
| "'" (<a href="#NT-PubidChar">PubidChar</a> - "'")* "'"</code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-PubidChar"></a>[13]<5D><><EFBFBD></td><td><code>PubidChar</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>#x20 | #xD | #xA |<7C>[a-zA-Z0-9] |<7C>[-'()+,./:=?;!*#@$_%]</code></td><xsltdebug></xsltdebug></tr></tbody></table>
|
||||||
<div class="diff-add"><div class="note"><p class="prefix"><b>Note:</b></p>
|
<div class="diff-add"><div class="note"><p class="prefix"><b>Note:</b></p>
|
||||||
<p><a href="http://www.w3.org/XML/xml-19980210-errata#E72">[E72]</a>Although
|
<p><a href="http://www.w3.org/XML/xml-19980210-errata#E72">[E72]</a>Although
|
||||||
the <a href="#NT-EntityValue">EntityValue</a> production allows the definition
|
the <a href="#NT-EntityValue">EntityValue</a> production allows the definition
|
||||||
of an entity consisting of a single explicit <code><</code> in the literal
|
of an entity consisting of a single explicit <code><</code> in the literal
|
||||||
(e.g., <code><!ENTITY mylt "<"></code>), it is strongly advised to avoid
|
(e.g., <code><!ENTITY mylt "<"></code>), it is strongly advised to avoid
|
||||||
this practice since any reference to that entity will cause a well-formedness
|
this practice since any reference to that entity will cause a well-formedness
|
||||||
error.</p>
|
error.</p>
|
||||||
</div></div>
|
</div></div>
|
||||||
@ -371,20 +371,20 @@ are also legal within the <a title="Literal Entity Value" href="#dt-litentval">l
|
|||||||
of an internal entity declaration; see <a href="#wf-entities"><b>4.3.2 Well-Formed Parsed Entities</b></a>.</span>
|
of an internal entity declaration; see <a href="#wf-entities"><b>4.3.2 Well-Formed Parsed Entities</b></a>.</span>
|
||||||
If they are needed elsewhere, they must be <a title="escape" href="#dt-escape">escaped</a>
|
If they are needed elsewhere, they must be <a title="escape" href="#dt-escape">escaped</a>
|
||||||
using either <a title="Character Reference" href="#dt-charref">numeric character references</a>
|
using either <a title="Character Reference" href="#dt-charref">numeric character references</a>
|
||||||
or the strings "<code>&amp;</code>" and "<code>&lt;</code>"
|
or the strings "<code>&amp;</code>" and "<code>&lt;</code>"
|
||||||
respectively. The right angle bracket (>) may be represented using the string "<code>&gt;</code>",
|
respectively. The right angle bracket (>) may be represented using the string "<code>&gt;</code>",
|
||||||
and must, <a title="For Compatibility" href="#dt-compat">for compatibility</a>, be escaped
|
and must, <a title="For Compatibility" href="#dt-compat">for compatibility</a>, be escaped
|
||||||
using "<code>&gt;</code>" or a character reference when it
|
using "<code>&gt;</code>" or a character reference when it
|
||||||
appears in the string "<code>]]></code>" in content, when
|
appears in the string "<code>]]></code>" in content, when
|
||||||
that string is not marking the end of a <a title="CDATA Section" href="#dt-cdsection">CDATA
|
that string is not marking the end of a <a title="CDATA Section" href="#dt-cdsection">CDATA
|
||||||
section</a>.</p>
|
section</a>.</p>
|
||||||
<p>In the content of elements, character data is any string of characters
|
<p>In the content of elements, character data is any string of characters
|
||||||
which does not contain the start-delimiter of any markup. In a CDATA section,
|
which does not contain the start-delimiter of any markup. In a CDATA section,
|
||||||
character data is any string of characters not including the CDATA-section-close
|
character data is any string of characters not including the CDATA-section-close
|
||||||
delimiter, "<code>]]></code>".</p>
|
delimiter, "<code>]]></code>".</p>
|
||||||
<p>To allow attribute values to contain both single and double quotes, the
|
<p>To allow attribute values to contain both single and double quotes, the
|
||||||
apostrophe or single-quote character (') may be represented as "<code>&apos;</code>",
|
apostrophe or single-quote character (') may be represented as "<code>&apos;</code>",
|
||||||
and the double-quote character (") as "<code>&quot;</code>".</p>
|
and the double-quote character (") as "<code>&quot;</code>".</p>
|
||||||
|
|
||||||
<h5>Character Data</h5><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td><a name="NT-CharData"></a>[14]<5D><><EFBFBD></td><td><code>CharData</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>[^<&]* - ([^<&]* ']]>' [^<&]*)</code></td><xsltdebug></xsltdebug></tr></tbody></table>
|
<h5>Character Data</h5><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td><a name="NT-CharData"></a>[14]<5D><><EFBFBD></td><td><code>CharData</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>[^<&]* - ([^<&]* ']]>' [^<&]*)</code></td><xsltdebug></xsltdebug></tr></tbody></table>
|
||||||
</div>
|
</div>
|
||||||
@ -397,7 +397,7 @@ in addition, they may appear within the document type declaration at places
|
|||||||
allowed by the grammar. They are not part of the document's <a title="Character Data" href="#dt-chardata">character
|
allowed by the grammar. They are not part of the document's <a title="Character Data" href="#dt-chardata">character
|
||||||
data</a>; an XML processor may, but need not, make it possible for an
|
data</a>; an XML processor may, but need not, make it possible for an
|
||||||
application to retrieve the text of comments. <a title="For Compatibility" href="#dt-compat">For
|
application to retrieve the text of comments. <a title="For Compatibility" href="#dt-compat">For
|
||||||
compatibility</a>, the string "<code>--</code>" (double-hyphen)
|
compatibility</a>, the string "<code>--</code>" (double-hyphen)
|
||||||
must not occur within comments.] <span class="diff-add"><a href="http://www.w3.org/XML/xml-19980210-errata#E63">[E63]</a>Parameter
|
must not occur within comments.] <span class="diff-add"><a href="http://www.w3.org/XML/xml-19980210-errata#E63">[E63]</a>Parameter
|
||||||
entity references are not recognized within comments.</span></p>
|
entity references are not recognized within comments.</span></p>
|
||||||
|
|
||||||
@ -422,7 +422,7 @@ following example is <em>not</em> well-formed.</p></div>
|
|||||||
<p>PIs are not part of the document's <a title="Character Data" href="#dt-chardata">character
|
<p>PIs are not part of the document's <a title="Character Data" href="#dt-chardata">character
|
||||||
data</a>, but must be passed through to the application. The PI begins
|
data</a>, but must be passed through to the application. The PI begins
|
||||||
with a target (<a href="#NT-PITarget">PITarget</a>) used to identify the application
|
with a target (<a href="#NT-PITarget">PITarget</a>) used to identify the application
|
||||||
to which the instruction is directed. The target names "<code>XML</code>", "<code>xml</code>",
|
to which the instruction is directed. The target names "<code>XML</code>", "<code>xml</code>",
|
||||||
and so on are reserved for standardization in this or future versions of this
|
and so on are reserved for standardization in this or future versions of this
|
||||||
specification. The XML <a title="Notation" href="#dt-notation">Notation</a> mechanism
|
specification. The XML <a title="Notation" href="#dt-notation">Notation</a> mechanism
|
||||||
may be used for formal declaration of PI targets. <span class="diff-add"><a href="http://www.w3.org/XML/xml-19980210-errata#E63">[E63]</a>Parameter
|
may be used for formal declaration of PI targets. <span class="diff-add"><a href="http://www.w3.org/XML/xml-19980210-errata#E63">[E63]</a>Parameter
|
||||||
@ -434,17 +434,17 @@ entity references are not recognized within processing instructions.</span></p>
|
|||||||
<p>[<a name="dt-cdsection" title="CDATA Section">Definition</a>: <b>CDATA sections</b>
|
<p>[<a name="dt-cdsection" title="CDATA Section">Definition</a>: <b>CDATA sections</b>
|
||||||
may occur anywhere character data may occur; they are used to escape blocks
|
may occur anywhere character data may occur; they are used to escape blocks
|
||||||
of text containing characters which would otherwise be recognized as markup.
|
of text containing characters which would otherwise be recognized as markup.
|
||||||
CDATA sections begin with the string "<code><![CDATA[</code>"
|
CDATA sections begin with the string "<code><![CDATA[</code>"
|
||||||
and end with the string "<code>]]></code>":]</p>
|
and end with the string "<code>]]></code>":]</p>
|
||||||
|
|
||||||
<h5>CDATA Sections</h5><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td><a name="NT-CDSect"></a>[18]<5D><><EFBFBD></td><td><code>CDSect</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code><a href="#NT-CDStart">CDStart</a> <a href="#NT-CData">CData</a> <a href="#NT-CDEnd">CDEnd</a></code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-CDStart"></a>[19]<5D><><EFBFBD></td><td><code>CDStart</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'<![CDATA['</code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-CData"></a>[20]<5D><><EFBFBD></td><td><code>CData</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>(<a href="#NT-Char">Char</a>* - (<a href="#NT-Char">Char</a>*
|
<h5>CDATA Sections</h5><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td><a name="NT-CDSect"></a>[18]<5D><><EFBFBD></td><td><code>CDSect</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code><a href="#NT-CDStart">CDStart</a> <a href="#NT-CData">CData</a> <a href="#NT-CDEnd">CDEnd</a></code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-CDStart"></a>[19]<5D><><EFBFBD></td><td><code>CDStart</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'<![CDATA['</code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-CData"></a>[20]<5D><><EFBFBD></td><td><code>CData</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>(<a href="#NT-Char">Char</a>* - (<a href="#NT-Char">Char</a>*
|
||||||
']]>' <a href="#NT-Char">Char</a>*)) </code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-CDEnd"></a>[21]<5D><><EFBFBD></td><td><code>CDEnd</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>']]>'</code></td><xsltdebug></xsltdebug></tr></tbody></table>
|
']]>' <a href="#NT-Char">Char</a>*)) </code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-CDEnd"></a>[21]<5D><><EFBFBD></td><td><code>CDEnd</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>']]>'</code></td><xsltdebug></xsltdebug></tr></tbody></table>
|
||||||
<p>Within a CDATA section, only the <a href="#NT-CDEnd">CDEnd</a> string is
|
<p>Within a CDATA section, only the <a href="#NT-CDEnd">CDEnd</a> string is
|
||||||
recognized as markup, so that left angle brackets and ampersands may occur
|
recognized as markup, so that left angle brackets and ampersands may occur
|
||||||
in their literal form; they need not (and cannot) be escaped using "<code>&lt;</code>"
|
in their literal form; they need not (and cannot) be escaped using "<code>&lt;</code>"
|
||||||
and "<code>&amp;</code>". CDATA sections cannot nest.</p>
|
and "<code>&amp;</code>". CDATA sections cannot nest.</p>
|
||||||
<p>An example of a CDATA section, in which "<code><greeting></code>"
|
<p>An example of a CDATA section, in which "<code><greeting></code>"
|
||||||
and "<code></greeting></code>" are recognized as <a title="Character Data" href="#dt-chardata">character data</a>, not <a title="Markup" href="#dt-markup">markup</a>:</p>
|
and "<code></greeting></code>" are recognized as <a title="Character Data" href="#dt-chardata">character data</a>, not <a title="Markup" href="#dt-markup">markup</a>:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><![CDATA[<greeting>Hello, world!</greeting>]]> </pre></td></tr></table>
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><![CDATA[<greeting>Hello, world!</greeting>]]> </pre></td></tr></table>
|
||||||
</div>
|
</div>
|
||||||
<div class="div2">
|
<div class="div2">
|
||||||
@ -453,14 +453,14 @@ and "<code></greeting></code>" are recognized as <a title="Chara
|
|||||||
<p>[<a name="dt-xmldecl" title="XML Declaration">Definition</a>: XML documents <span class="diff-chg"><a href="http://www.w3.org/XML/xml-19980210-errata#E107">[E107]</a>should</span>
|
<p>[<a name="dt-xmldecl" title="XML Declaration">Definition</a>: XML documents <span class="diff-chg"><a href="http://www.w3.org/XML/xml-19980210-errata#E107">[E107]</a>should</span>
|
||||||
begin with an <b>XML declaration</b> which specifies the version of
|
begin with an <b>XML declaration</b> which specifies the version of
|
||||||
XML being used.] For example, the following is a complete XML document, <a title="Well-Formed" href="#dt-wellformed">well-formed</a> but not <a title="Validity" href="#dt-valid">valid</a>:</p>
|
XML being used.] For example, the following is a complete XML document, <a title="Well-Formed" href="#dt-wellformed">well-formed</a> but not <a title="Validity" href="#dt-valid">valid</a>:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><?xml version="1.0"?> <greeting>Hello, world!</greeting> </pre></td></tr></table>
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><?xml version="1.0"?> <greeting>Hello, world!</greeting> </pre></td></tr></table>
|
||||||
<p>and so is this:</p>
|
<p>and so is this:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><greeting>Hello, world!</greeting></pre></td></tr></table>
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><greeting>Hello, world!</greeting></pre></td></tr></table>
|
||||||
<p>The version number "<code>1.0</code>" should be used to indicate
|
<p>The version number "<code>1.0</code>" should be used to indicate
|
||||||
conformance to this version of this specification; it is an error for a document
|
conformance to this version of this specification; it is an error for a document
|
||||||
to use the value "<code>1.0</code>" if it does not conform to
|
to use the value "<code>1.0</code>" if it does not conform to
|
||||||
this version of this specification. It is the intent of the XML working group
|
this version of this specification. It is the intent of the XML working group
|
||||||
to give later versions of this specification numbers other than "<code>1.0</code>",
|
to give later versions of this specification numbers other than "<code>1.0</code>",
|
||||||
but this intent does not indicate a commitment to produce any future versions
|
but this intent does not indicate a commitment to produce any future versions
|
||||||
of XML, nor if any are produced, to use any particular numbering scheme. Since
|
of XML, nor if any are produced, to use any particular numbering scheme. Since
|
||||||
future versions are not ruled out, this construct is provided as a means to
|
future versions are not ruled out, this construct is provided as a means to
|
||||||
@ -482,8 +482,8 @@ in the document.</p>
|
|||||||
(<a href="#NT-doctypedecl">doctypedecl</a> <a href="#NT-Misc">Misc</a>*)?</code></td><xsltdebug></xsltdebug></tr>
|
(<a href="#NT-doctypedecl">doctypedecl</a> <a href="#NT-Misc">Misc</a>*)?</code></td><xsltdebug></xsltdebug></tr>
|
||||||
<tr valign="baseline"><td><a name="NT-XMLDecl"></a>[23]<5D><><EFBFBD></td><td><code>XMLDecl</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'<?xml' <a href="#NT-VersionInfo">VersionInfo</a> <a href="#NT-EncodingDecl">EncodingDecl</a>? <a href="#NT-SDDecl">SDDecl</a>? <a href="#NT-S">S</a>? '?>'</code></td><xsltdebug></xsltdebug></tr>
|
<tr valign="baseline"><td><a name="NT-XMLDecl"></a>[23]<5D><><EFBFBD></td><td><code>XMLDecl</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'<?xml' <a href="#NT-VersionInfo">VersionInfo</a> <a href="#NT-EncodingDecl">EncodingDecl</a>? <a href="#NT-SDDecl">SDDecl</a>? <a href="#NT-S">S</a>? '?>'</code></td><xsltdebug></xsltdebug></tr>
|
||||||
<tr valign="baseline"><td class="diff-chg"><a name="NT-VersionInfo"></a>[24]<5D><><EFBFBD></td><td class="diff-chg"><code>VersionInfo</code></td><td class="diff-chg"><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td class="diff-chg"><code><a href="#NT-S">S</a> 'version' <a href="#NT-Eq">Eq</a>
|
<tr valign="baseline"><td class="diff-chg"><a name="NT-VersionInfo"></a>[24]<5D><><EFBFBD></td><td class="diff-chg"><code>VersionInfo</code></td><td class="diff-chg"><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td class="diff-chg"><code><a href="#NT-S">S</a> 'version' <a href="#NT-Eq">Eq</a>
|
||||||
("'" <a href="#NT-VersionNum">VersionNum</a> "'" | '"' <a href="#NT-VersionNum">VersionNum</a>
|
("'" <a href="#NT-VersionNum">VersionNum</a> "'" | '"' <a href="#NT-VersionNum">VersionNum</a>
|
||||||
'"')<i>/* <a href="http://www.w3.org/XML/xml-19980210-errata#E15">[E15]</a> */</i></code></td><xsltdebug></xsltdebug></tr>
|
'"')<i>/* <a href="http://www.w3.org/XML/xml-19980210-errata#E15">[E15]</a> */</i></code></td><xsltdebug></xsltdebug></tr>
|
||||||
<tr valign="baseline"><td><a name="NT-Eq"></a>[25]<5D><><EFBFBD></td><td><code>Eq</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code><a href="#NT-S">S</a>? '=' <a href="#NT-S">S</a>?</code></td><xsltdebug></xsltdebug></tr>
|
<tr valign="baseline"><td><a name="NT-Eq"></a>[25]<5D><><EFBFBD></td><td><code>Eq</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code><a href="#NT-S">S</a>? '=' <a href="#NT-S">S</a>?</code></td><xsltdebug></xsltdebug></tr>
|
||||||
<tr valign="baseline"><td><a name="NT-VersionNum"></a>[26]<5D><><EFBFBD></td><td><code>VersionNum</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>([a-zA-Z0-9_.:] | '-')+</code></td><xsltdebug></xsltdebug></tr>
|
<tr valign="baseline"><td><a name="NT-VersionNum"></a>[26]<5D><><EFBFBD></td><td><code>VersionNum</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>([a-zA-Z0-9_.:] | '-')+</code></td><xsltdebug></xsltdebug></tr>
|
||||||
<tr valign="baseline"><td><a name="NT-Misc"></a>[27]<5D><><EFBFBD></td><td><code>Misc</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code><a href="#NT-Comment">Comment</a> | <a href="#NT-PI">PI</a>
|
<tr valign="baseline"><td><a name="NT-Misc"></a>[27]<5D><><EFBFBD></td><td><code>Misc</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code><a href="#NT-Comment">Comment</a> | <a href="#NT-PI">PI</a>
|
||||||
@ -569,12 +569,12 @@ internal subset in that in them, <a title="Parameter-entity reference" href="#dt
|
|||||||
references</a> are permitted <em>within</em> markup declarations,
|
references</a> are permitted <em>within</em> markup declarations,
|
||||||
not only <em>between</em> markup declarations.</p>
|
not only <em>between</em> markup declarations.</p>
|
||||||
<p>An example of an XML document with a document type declaration:</p>
|
<p>An example of an XML document with a document type declaration:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><?xml version="1.0"?> <!DOCTYPE greeting SYSTEM "hello.dtd"> <greeting>Hello, world!</greeting> </pre></td></tr></table>
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><?xml version="1.0"?> <!DOCTYPE greeting SYSTEM "hello.dtd"> <greeting>Hello, world!</greeting> </pre></td></tr></table>
|
||||||
<p>The <a title="System Identifier" href="#dt-sysid">system identifier</a> "<code>hello.dtd</code>"
|
<p>The <a title="System Identifier" href="#dt-sysid">system identifier</a> "<code>hello.dtd</code>"
|
||||||
gives the <span class="diff-chg"><a href="http://www.w3.org/XML/xml-19980210-errata#E78">[E78]</a>address
|
gives the <span class="diff-chg"><a href="http://www.w3.org/XML/xml-19980210-errata#E78">[E78]</a>address
|
||||||
(a URI reference)</span> of a DTD for the document.</p>
|
(a URI reference)</span> of a DTD for the document.</p>
|
||||||
<p>The declarations can also be given locally, as in this example:</p>
|
<p>The declarations can also be given locally, as in this example:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><?xml version="1.0" encoding="UTF-8" ?>
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><?xml version="1.0" encoding="UTF-8" ?>
|
||||||
<!DOCTYPE greeting [
|
<!DOCTYPE greeting [
|
||||||
<!ELEMENT greeting (#PCDATA)>
|
<!ELEMENT greeting (#PCDATA)>
|
||||||
]>
|
]>
|
||||||
@ -601,24 +601,24 @@ them).]</span></p>
|
|||||||
|
|
||||||
<h5>Standalone Document Declaration</h5><table class="scrap" summary="Scrap"><tbody>
|
<h5>Standalone Document Declaration</h5><table class="scrap" summary="Scrap"><tbody>
|
||||||
<tr valign="baseline"><td><a name="NT-SDDecl"></a>[32]<5D><><EFBFBD></td><td><code>SDDecl</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code> <a href="#NT-S">S</a> 'standalone' <a href="#NT-Eq">Eq</a>
|
<tr valign="baseline"><td><a name="NT-SDDecl"></a>[32]<5D><><EFBFBD></td><td><code>SDDecl</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code> <a href="#NT-S">S</a> 'standalone' <a href="#NT-Eq">Eq</a>
|
||||||
(("'" ('yes' | 'no') "'") | ('"' ('yes' | 'no') '"')) </code></td><xsltdebug></xsltdebug><td><a href="#vc-check-rmd">[VC: Standalone Document Declaration]</a></td></tr>
|
(("'" ('yes' | 'no') "'") | ('"' ('yes' | 'no') '"')) </code></td><xsltdebug></xsltdebug><td><a href="#vc-check-rmd">[VC: Standalone Document Declaration]</a></td></tr>
|
||||||
</tbody></table>
|
</tbody></table>
|
||||||
<p>In a standalone document declaration, the value "yes" indicates
|
<p>In a standalone document declaration, the value "yes" indicates
|
||||||
that there are no <span class="diff-chg"><a href="http://www.w3.org/XML/xml-19980210-errata#E64">[E64]</a><a title="External Markup Declaration" href="#dt-extmkpdecl">external markup declarations</a></span> which
|
that there are no <span class="diff-chg"><a href="http://www.w3.org/XML/xml-19980210-errata#E64">[E64]</a><a title="External Markup Declaration" href="#dt-extmkpdecl">external markup declarations</a></span> which
|
||||||
affect the information passed from the XML processor to the application. The
|
affect the information passed from the XML processor to the application. The
|
||||||
value "no" indicates that there are or may be such external
|
value "no" indicates that there are or may be such external
|
||||||
markup declarations. Note that the standalone document declaration only denotes
|
markup declarations. Note that the standalone document declaration only denotes
|
||||||
the presence of external <em>declarations</em>; the presence, in a document,
|
the presence of external <em>declarations</em>; the presence, in a document,
|
||||||
of references to external <em>entities</em>, when those entities are internally
|
of references to external <em>entities</em>, when those entities are internally
|
||||||
declared, does not change its standalone status.</p>
|
declared, does not change its standalone status.</p>
|
||||||
<p>If there are no external markup declarations, the standalone document declaration
|
<p>If there are no external markup declarations, the standalone document declaration
|
||||||
has no meaning. If there are external markup declarations but there is no
|
has no meaning. If there are external markup declarations but there is no
|
||||||
standalone document declaration, the value "no" is assumed.</p>
|
standalone document declaration, the value "no" is assumed.</p>
|
||||||
<p>Any XML document for which <code>standalone="no"</code> holds can be converted
|
<p>Any XML document for which <code>standalone="no"</code> holds can be converted
|
||||||
algorithmically to a standalone document, which may be desirable for some
|
algorithmically to a standalone document, which may be desirable for some
|
||||||
network delivery applications.</p>
|
network delivery applications.</p>
|
||||||
<div class="constraint"><p class="prefix"><a name="vc-check-rmd"></a><b>Validity constraint: Standalone Document Declaration</b></p><p>The
|
<div class="constraint"><p class="prefix"><a name="vc-check-rmd"></a><b>Validity constraint: Standalone Document Declaration</b></p><p>The
|
||||||
standalone document declaration must have the value "no" if
|
standalone document declaration must have the value "no" if
|
||||||
any external markup declarations contain declarations of:</p>
|
any external markup declarations contain declarations of:</p>
|
||||||
<ul>
|
<ul>
|
||||||
<li><p>attributes with <a title="Attribute Default" href="#dt-default">default</a> values,
|
<li><p>attributes with <a title="Attribute Default" href="#dt-default">default</a> values,
|
||||||
@ -638,17 +638,17 @@ if white space occurs directly within any instance of those types.</p></li>
|
|||||||
</ul>
|
</ul>
|
||||||
</div>
|
</div>
|
||||||
<p>An example XML declaration with a standalone document declaration:</p>
|
<p>An example XML declaration with a standalone document declaration:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><?xml version="1.0" standalone='yes'?></pre></td></tr></table>
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><?xml version="1.0" standalone='yes'?></pre></td></tr></table>
|
||||||
</div>
|
</div>
|
||||||
<div class="div2">
|
<div class="div2">
|
||||||
|
|
||||||
<h3><a name="sec-white-space"></a>2.10 White Space Handling</h3>
|
<h3><a name="sec-white-space"></a>2.10 White Space Handling</h3>
|
||||||
<p>In editing XML documents, it is often convenient to use "white space"
|
<p>In editing XML documents, it is often convenient to use "white space"
|
||||||
(spaces, tabs, and blank lines<span class="diff-del"><a href="http://www.w3.org/XML/xml-19980210-errata#E39">[E39]</a>,
|
(spaces, tabs, and blank lines<span class="diff-del"><a href="http://www.w3.org/XML/xml-19980210-errata#E39">[E39]</a>,
|
||||||
denoted by the nonterminal <a href="#NT-S">S</a> in this specification</span>)
|
denoted by the nonterminal <a href="#NT-S">S</a> in this specification</span>)
|
||||||
to set apart the markup for greater readability. Such white space is typically
|
to set apart the markup for greater readability. Such white space is typically
|
||||||
not intended for inclusion in the delivered version of the document. On the
|
not intended for inclusion in the delivered version of the document. On the
|
||||||
other hand, "significant" white space that should be preserved
|
other hand, "significant" white space that should be preserved
|
||||||
in the delivered version is common, for example in poetry and source code.</p>
|
in the delivered version is common, for example in poetry and source code.</p>
|
||||||
<p>An <a title="XML Processor" href="#dt-xml-proc">XML processor</a> must always pass
|
<p>An <a title="XML Processor" href="#dt-xml-proc">XML processor</a> must always pass
|
||||||
all characters in a document that are not markup through to the application.
|
all characters in a document that are not markup through to the application.
|
||||||
@ -661,14 +661,14 @@ white space should be preserved by applications. In valid documents, this
|
|||||||
attribute, like any other, must be <a title="Attribute-List Declaration" href="#dt-attdecl">declared</a>
|
attribute, like any other, must be <a title="Attribute-List Declaration" href="#dt-attdecl">declared</a>
|
||||||
if it is used. When declared, it must be given as an <a title="Enumerated Attribute Values" href="#dt-enumerated">enumerated
|
if it is used. When declared, it must be given as an <a title="Enumerated Attribute Values" href="#dt-enumerated">enumerated
|
||||||
type</a> whose <span class="diff-chg"><a href="http://www.w3.org/XML/xml-19980210-errata#E81">[E81]</a>values
|
type</a> whose <span class="diff-chg"><a href="http://www.w3.org/XML/xml-19980210-errata#E81">[E81]</a>values
|
||||||
are one or both of</span> "default" and "preserve".
|
are one or both of</span> "default" and "preserve".
|
||||||
For example:</p>
|
For example:</p>
|
||||||
<div class="diff-chg"><table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td class="diff-chg"><pre><!ATTLIST poem xml:space (default|preserve) 'preserve'>
|
<div class="diff-chg"><table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td class="diff-chg"><pre><!ATTLIST poem xml:space (default|preserve) 'preserve'>
|
||||||
|
|
||||||
<!-- <a href="http://www.w3.org/XML/xml-19980210-errata#E81">[E81]</a>-->
|
<!-- <a href="http://www.w3.org/XML/xml-19980210-errata#E81">[E81]</a>-->
|
||||||
<!ATTLIST pre xml:space (preserve) #FIXED 'preserve'></pre></td></tr></table></div>
|
<!ATTLIST pre xml:space (preserve) #FIXED 'preserve'></pre></td></tr></table></div>
|
||||||
<p>The value "default" signals that applications' default white-space
|
<p>The value "default" signals that applications' default white-space
|
||||||
processing modes are acceptable for this element; the value "preserve"
|
processing modes are acceptable for this element; the value "preserve"
|
||||||
indicates the intent that applications preserve all the white space. This
|
indicates the intent that applications preserve all the white space. This
|
||||||
declared intent is considered to apply to all elements within the content
|
declared intent is considered to apply to all elements within the content
|
||||||
of the element where it is specified, unless overriden with another instance
|
of the element where it is specified, unless overriden with another instance
|
||||||
@ -687,7 +687,7 @@ These lines are typically separated by some combination of the characters
|
|||||||
carriage-return (#xD) and line-feed (#xA).</p>
|
carriage-return (#xD) and line-feed (#xA).</p>
|
||||||
<div class="diff-del"><p>To simplify the tasks of <a title="Application" href="#dt-app">applications</a>,
|
<div class="diff-del"><p>To simplify the tasks of <a title="Application" href="#dt-app">applications</a>,
|
||||||
wherever an external parsed entity or the literal entity value of an internal
|
wherever an external parsed entity or the literal entity value of an internal
|
||||||
parsed entity contains either the literal two-character sequence "#xD#xA"
|
parsed entity contains either the literal two-character sequence "#xD#xA"
|
||||||
or a standalone literal #xD, an <a title="XML Processor" href="#dt-xml-proc">XML processor</a>
|
or a standalone literal #xD, an <a title="XML Processor" href="#dt-xml-proc">XML processor</a>
|
||||||
must pass to the application the single character #xA. (This behavior can
|
must pass to the application the single character #xA. (This behavior can
|
||||||
conveniently be produced by normalizing all line breaks to #xA on input, before
|
conveniently be produced by normalizing all line breaks to #xA on input, before
|
||||||
@ -730,28 +730,28 @@ languages not presently covered by <a href="#ISO639">[ISO 639]</a>.</p>
|
|||||||
for the representation of names of languages</cite></p></li>
|
for the representation of names of languages</cite></p></li>
|
||||||
<li><p>a language identifier registered with the Internet Assigned Numbers
|
<li><p>a language identifier registered with the Internet Assigned Numbers
|
||||||
Authority <span class="diff-chg"><a href="#IANA-LANGCODES">[IANA-LANGCODES]</a></span>; these begin with the
|
Authority <span class="diff-chg"><a href="#IANA-LANGCODES">[IANA-LANGCODES]</a></span>; these begin with the
|
||||||
prefix "<code>i-</code>" (or "<code>I-</code>")</p>
|
prefix "<code>i-</code>" (or "<code>I-</code>")</p>
|
||||||
</li>
|
</li>
|
||||||
<li><p>a language identifier assigned by the user, or agreed on between
|
<li><p>a language identifier assigned by the user, or agreed on between
|
||||||
parties in private use; these must begin with the prefix "<code>x-</code>"
|
parties in private use; these must begin with the prefix "<code>x-</code>"
|
||||||
or "<code>X-</code>" in order to ensure that they do not conflict
|
or "<code>X-</code>" in order to ensure that they do not conflict
|
||||||
with names later standardized or registered with IANA</p></li>
|
with names later standardized or registered with IANA</p></li>
|
||||||
</ul></div>
|
</ul></div>
|
||||||
<div class="diff-del"><p>There may be any number of <a href="#NT-Subcode">Subcode</a>
|
<div class="diff-del"><p>There may be any number of <a href="#NT-Subcode">Subcode</a>
|
||||||
segments; if the first subcode segment exists and the Subcode consists of
|
segments; if the first subcode segment exists and the Subcode consists of
|
||||||
two letters, then it must be a country code from <a href="#ISO3166">[ISO 3166]</a>,
|
two letters, then it must be a country code from <a href="#ISO3166">[ISO 3166]</a>,
|
||||||
"Codes for the representation of names of countries." If the first subcode
|
"Codes for the representation of names of countries." If the first subcode
|
||||||
consists of more than two letters, it must be a subcode for the language in
|
consists of more than two letters, it must be a subcode for the language in
|
||||||
question registered with IANA, unless the <a href="#NT-Langcode">Langcode</a>
|
question registered with IANA, unless the <a href="#NT-Langcode">Langcode</a>
|
||||||
begins with the prefix "<code>x-</code>" or "<code>X-</code>". </p></div>
|
begins with the prefix "<code>x-</code>" or "<code>X-</code>". </p></div>
|
||||||
<div class="diff-del"><p>It is customary to give the language code in lower case, and
|
<div class="diff-del"><p>It is customary to give the language code in lower case, and
|
||||||
the country code (if any) in upper case. Note that these values, unlike other
|
the country code (if any) in upper case. Note that these values, unlike other
|
||||||
names in XML documents, are case insensitive.</p></div>
|
names in XML documents, are case insensitive.</p></div>
|
||||||
<p>For example:</p>
|
<p>For example:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><p xml:lang="en">The quick brown fox jumps over the lazy dog.</p>
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><p xml:lang="en">The quick brown fox jumps over the lazy dog.</p>
|
||||||
<p xml:lang="en-GB">What colour is it?</p>
|
<p xml:lang="en-GB">What colour is it?</p>
|
||||||
<p xml:lang="en-US">What color is it?</p>
|
<p xml:lang="en-US">What color is it?</p>
|
||||||
<sp who="Faust" desc='leise' xml:lang="de">
|
<sp who="Faust" desc='leise' xml:lang="de">
|
||||||
<l>Habe nun, ach! Philosophie,</l>
|
<l>Habe nun, ach! Philosophie,</l>
|
||||||
<l>Juristerei, und Medizin</l>
|
<l>Juristerei, und Medizin</l>
|
||||||
<l>und leider auch Theologie</l>
|
<l>und leider auch Theologie</l>
|
||||||
@ -781,8 +781,8 @@ document</a> contains one or more <b>elements</b>, the boundaries
|
|||||||
of which are either delimited by <a title="Start-Tag" href="#dt-stag">start-tags</a>
|
of which are either delimited by <a title="Start-Tag" href="#dt-stag">start-tags</a>
|
||||||
and <a title="End Tag" href="#dt-etag">end-tags</a>, or, for <a title="Empty" href="#dt-empty">empty</a>
|
and <a title="End Tag" href="#dt-etag">end-tags</a>, or, for <a title="Empty" href="#dt-empty">empty</a>
|
||||||
elements, by an <a title="empty-element tag" href="#dt-eetag">empty-element tag</a>. Each
|
elements, by an <a title="empty-element tag" href="#dt-eetag">empty-element tag</a>. Each
|
||||||
element has a type, identified by name, sometimes called its "generic
|
element has a type, identified by name, sometimes called its "generic
|
||||||
identifier" (GI), and may have a set of attribute specifications.]
|
identifier" (GI), and may have a set of attribute specifications.]
|
||||||
Each attribute specification has a <a title="Attribute Name" href="#dt-attrname">name</a>
|
Each attribute specification has a <a title="Attribute Name" href="#dt-attrname">name</a>
|
||||||
and a <a title="Attribute Value" href="#dt-attrval">value</a>.</p>
|
and a <a title="Attribute Value" href="#dt-attrval">value</a>.</p>
|
||||||
|
|
||||||
@ -828,7 +828,7 @@ XML element is marked by a <b>start-tag</b>.]</p>
|
|||||||
<p>The <a href="#NT-Name">Name</a> in the start- and end-tags gives the element's <b>type</b>. [<a name="dt-attr" title="Attribute">Definition</a>: The <a href="#NT-Name">Name</a>-<a href="#NT-AttValue">AttValue</a>
|
<p>The <a href="#NT-Name">Name</a> in the start- and end-tags gives the element's <b>type</b>. [<a name="dt-attr" title="Attribute">Definition</a>: The <a href="#NT-Name">Name</a>-<a href="#NT-AttValue">AttValue</a>
|
||||||
pairs are referred to as the <b>attribute specifications</b> of the
|
pairs are referred to as the <b>attribute specifications</b> of the
|
||||||
element], [<a name="dt-attrname" title="Attribute Name">Definition</a>: with the <a href="#NT-Name">Name</a> in each pair referred to as the <b>attribute name</b>]
|
element], [<a name="dt-attrname" title="Attribute Name">Definition</a>: with the <a href="#NT-Name">Name</a> in each pair referred to as the <b>attribute name</b>]
|
||||||
and [<a name="dt-attrval" title="Attribute Value">Definition</a>: the content of the <a href="#NT-AttValue">AttValue</a> (the text between the <code>'</code> or <code>"</code>
|
and [<a name="dt-attrval" title="Attribute Value">Definition</a>: the content of the <a href="#NT-AttValue">AttValue</a> (the text between the <code>'</code> or <code>"</code>
|
||||||
delimiters) as the <b>attribute value</b>.]<span class="diff-add"><a href="http://www.w3.org/XML/xml-19980210-errata#E46">[E46]</a>Note
|
delimiters) as the <b>attribute value</b>.]<span class="diff-add"><a href="http://www.w3.org/XML/xml-19980210-errata#E46">[E46]</a>Note
|
||||||
that the order of attribute specifications in a start-tag or empty-element
|
that the order of attribute specifications in a start-tag or empty-element
|
||||||
tag is not significant.</span></p>
|
tag is not significant.</span></p>
|
||||||
@ -845,10 +845,10 @@ values cannot contain direct or indirect entity references to external entities.
|
|||||||
<div class="constraint"><p class="prefix"><a name="CleanAttrVals"></a><b>Well-formedness constraint: No <code><</code> in Attribute Values</b></p>
|
<div class="constraint"><p class="prefix"><a name="CleanAttrVals"></a><b>Well-formedness constraint: No <code><</code> in Attribute Values</b></p>
|
||||||
<p>The <a title="Replacement Text" href="#dt-repltext">replacement text</a> of any entity
|
<p>The <a title="Replacement Text" href="#dt-repltext">replacement text</a> of any entity
|
||||||
referred to directly or indirectly in an attribute value <span class="diff-del"><a href="http://www.w3.org/XML/xml-19980210-errata#E83">[E83]</a>(other
|
referred to directly or indirectly in an attribute value <span class="diff-del"><a href="http://www.w3.org/XML/xml-19980210-errata#E83">[E83]</a>(other
|
||||||
than "<code>&lt;</code>") </span>must not contain a <code><</code>.</p>
|
than "<code>&lt;</code>") </span>must not contain a <code><</code>.</p>
|
||||||
</div>
|
</div>
|
||||||
<p>An example of a start-tag:</p>
|
<p>An example of a start-tag:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><termdef id="dt-dog" term="dog"></pre></td></tr></table>
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><termdef id="dt-dog" term="dog"></pre></td></tr></table>
|
||||||
<p>[<a name="dt-etag" title="End Tag">Definition</a>: The end of every element that begins
|
<p>[<a name="dt-etag" title="End Tag">Definition</a>: The end of every element that begins
|
||||||
with a start-tag must be marked by an <b>end-tag</b> containing a name
|
with a start-tag must be marked by an <b>end-tag</b> containing a name
|
||||||
that echoes the element's type as given in the start-tag:]</p>
|
that echoes the element's type as given in the start-tag:]</p>
|
||||||
@ -882,8 +882,8 @@ interoperability</a>, the empty-element tag <span class="diff-chg"><a href="http
|
|||||||
be used, and should only be used,</span> for elements which are declared
|
be used, and should only be used,</span> for elements which are declared
|
||||||
EMPTY.</p>
|
EMPTY.</p>
|
||||||
<p>Examples of empty elements:</p>
|
<p>Examples of empty elements:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><IMG align="left"
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><IMG align="left"
|
||||||
src="http://www.w3.org/Icons/WWW/w3c_home" />
|
src="http://www.w3.org/Icons/WWW/w3c_home" />
|
||||||
<br></br>
|
<br></br>
|
||||||
<br/></pre></td></tr></table>
|
<br/></pre></td></tr></table>
|
||||||
</div>
|
</div>
|
||||||
@ -987,8 +987,8 @@ but not their order or their number of occurrences:</p>
|
|||||||
</tbody></table>
|
</tbody></table>
|
||||||
<p>where the <a href="#NT-Name">Name</a>s give the types of elements that
|
<p>where the <a href="#NT-Name">Name</a>s give the types of elements that
|
||||||
may appear as children. <span class="diff-add"><a href="http://www.w3.org/XML/xml-19980210-errata#E10">[E10]</a>The
|
may appear as children. <span class="diff-add"><a href="http://www.w3.org/XML/xml-19980210-errata#E10">[E10]</a>The
|
||||||
keyword <b>#PCDATA</b> derives historically from the term "parsed
|
keyword <b>#PCDATA</b> derives historically from the term "parsed
|
||||||
character data."</span></p>
|
character data."</span></p>
|
||||||
<div class="constraint"><p class="prefix"><a name="vc-MixedChildrenUnique"></a><b>Validity constraint: No Duplicate Types</b></p><p>The
|
<div class="constraint"><p class="prefix"><a name="vc-MixedChildrenUnique"></a><b>Validity constraint: No Duplicate Types</b></p><p>The
|
||||||
same name must not appear more than once in a single mixed-content declaration.</p>
|
same name must not appear more than once in a single mixed-content declaration.</p>
|
||||||
</div>
|
</div>
|
||||||
@ -1142,9 +1142,9 @@ that attribute must match the default value.</p>
|
|||||||
id ID #REQUIRED
|
id ID #REQUIRED
|
||||||
name CDATA #IMPLIED>
|
name CDATA #IMPLIED>
|
||||||
<!ATTLIST list
|
<!ATTLIST list
|
||||||
type (bullets|ordered|glossary) "ordered">
|
type (bullets|ordered|glossary) "ordered">
|
||||||
<!ATTLIST form
|
<!ATTLIST form
|
||||||
method CDATA #FIXED "POST"></pre></td></tr></table>
|
method CDATA #FIXED "POST"></pre></td></tr></table>
|
||||||
</div>
|
</div>
|
||||||
<div class="diff-chg"><div class="div3">
|
<div class="diff-chg"><div class="div3">
|
||||||
|
|
||||||
@ -1193,21 +1193,21 @@ by a non-validating <span class="diff-chg"><a href="http://www.w3.org/XML/xml-19
|
|||||||
as if declared <b>CDATA</b>.</p>
|
as if declared <b>CDATA</b>.</p>
|
||||||
<p>Following are examples of attribute normalization. Given the following
|
<p>Following are examples of attribute normalization. Given the following
|
||||||
declarations:</p>
|
declarations:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY d "&#xD;">
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY d "&#xD;">
|
||||||
<!ENTITY a "&#xA;">
|
<!ENTITY a "&#xA;">
|
||||||
<!ENTITY da "&#xD;&#xA;"></pre></td></tr></table>
|
<!ENTITY da "&#xD;&#xA;"></pre></td></tr></table>
|
||||||
<p>the attribute specifications in the left column below would be normalized
|
<p>the attribute specifications in the left column below would be normalized
|
||||||
to the character sequences of the middle column if the attribute <code>a</code>
|
to the character sequences of the middle column if the attribute <code>a</code>
|
||||||
is declared <b>NMTOKENS</b> and to those of the right columns if <code>a</code>
|
is declared <b>NMTOKENS</b> and to those of the right columns if <code>a</code>
|
||||||
is declared <b>CDATA</b>.</p>
|
is declared <b>CDATA</b>.</p>
|
||||||
<table border="1" frame="border"><thead><tr><th colspan="1" rowspan="1">Attribute specification</th>
|
<table border="1" frame="border"><thead><tr><th colspan="1" rowspan="1">Attribute specification</th>
|
||||||
<th colspan="1" rowspan="1">a is NMTOKENS</th><th colspan="1" rowspan="1">a is CDATA</th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre>a="
|
<th colspan="1" rowspan="1">a is NMTOKENS</th><th colspan="1" rowspan="1">a is CDATA</th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre>a="
|
||||||
|
|
||||||
xyz"</pre></td></tr></table></td><td colspan="1" rowspan="1"><code>x y z</code></td><td colspan="1" rowspan="1"><code>#x20 #x20 x y z</code></td>
|
xyz"</pre></td></tr></table></td><td colspan="1" rowspan="1"><code>x y z</code></td><td colspan="1" rowspan="1"><code>#x20 #x20 x y z</code></td>
|
||||||
</tr><tr><td colspan="1" rowspan="1"><table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre>a="&d;&d;A&a;&a;B&da;"</pre></td></tr></table></td><td colspan="1" rowspan="1"><code>A
|
</tr><tr><td colspan="1" rowspan="1"><table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre>a="&d;&d;A&a;&a;B&da;"</pre></td></tr></table></td><td colspan="1" rowspan="1"><code>A
|
||||||
#x20 B</code></td><td colspan="1" rowspan="1"><code>#x20 #x20 A #x20 #x20 B #x20 #x20</code></td>
|
#x20 B</code></td><td colspan="1" rowspan="1"><code>#x20 #x20 A #x20 #x20 B #x20 #x20</code></td>
|
||||||
</tr><tr><td colspan="1" rowspan="1"><table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre>a=
|
</tr><tr><td colspan="1" rowspan="1"><table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre>a=
|
||||||
"&#xd;&#xd;A&#xa;&#xa;B&#xd;&#xa;"</pre></td></tr></table></td><td colspan="1" rowspan="1"><code>#xD
|
"&#xd;&#xd;A&#xa;&#xa;B&#xd;&#xa;"</pre></td></tr></table></td><td colspan="1" rowspan="1"><code>#xD
|
||||||
#xD A #xA #xA B #xD #xA</code></td><td colspan="1" rowspan="1"><code>#xD #xD A #xA #xA B #xD #xD</code></td>
|
#xD A #xA #xA B #xD #xA</code></td><td colspan="1" rowspan="1"><code>#xD #xD A #xA #xA B #xD #xD</code></td>
|
||||||
</tr></tbody></table>
|
</tr></tbody></table>
|
||||||
<p>Note that the last example is invalid (but well-formed) if <code>a</code>
|
<p>Note that the last example is invalid (but well-formed) if <code>a</code>
|
||||||
@ -1235,8 +1235,8 @@ Conditional Section/PE Nesting]</a></td></tr>
|
|||||||
('<![' | ']]>') <a href="#NT-Char">Char</a>*) </code></td><xsltdebug></xsltdebug></tr>
|
('<![' | ']]>') <a href="#NT-Char">Char</a>*) </code></td><xsltdebug></xsltdebug></tr>
|
||||||
</tbody></table>
|
</tbody></table>
|
||||||
<div class="diff-add"><div class="constraint"><p class="prefix"><a name="condsec-nesting"></a><b>Validity constraint: <a href="http://www.w3.org/XML/xml-19980210-errata#E90">[E90]</a>Proper
|
<div class="diff-add"><div class="constraint"><p class="prefix"><a name="condsec-nesting"></a><b>Validity constraint: <a href="http://www.w3.org/XML/xml-19980210-errata#E90">[E90]</a>Proper
|
||||||
Conditional Section/PE Nesting</b></p><p>If any of the "<code><![</code>",
|
Conditional Section/PE Nesting</b></p><p>If any of the "<code><![</code>",
|
||||||
"<code>[</code>", or "<code>]]></code>" of a conditional section is contained
|
"<code>[</code>", or "<code>]]></code>" of a conditional section is contained
|
||||||
in the replacement text for a parameter-entity reference, all of them must
|
in the replacement text for a parameter-entity reference, all of them must
|
||||||
be contained in the same replacement text.</p>
|
be contained in the same replacement text.</p>
|
||||||
</div></div>
|
</div></div>
|
||||||
@ -1254,8 +1254,8 @@ If a conditional section with a keyword of <b>INCLUDE</b> occurs within
|
|||||||
a larger conditional section with a keyword of <b>IGNORE</b>, both the outer
|
a larger conditional section with a keyword of <b>IGNORE</b>, both the outer
|
||||||
and the inner conditional sections are ignored.<span class="diff-add"> <a href="http://www.w3.org/XML/xml-19980210-errata#E90">[E90]</a>The contents
|
and the inner conditional sections are ignored.<span class="diff-add"> <a href="http://www.w3.org/XML/xml-19980210-errata#E90">[E90]</a>The contents
|
||||||
of an ignored conditional section are parsed by ignoring all characters after
|
of an ignored conditional section are parsed by ignoring all characters after
|
||||||
the "<code>[</code>" following the keyword, except conditional section starts
|
the "<code>[</code>" following the keyword, except conditional section starts
|
||||||
"<code><![</code>" and ends "<code>]]></code>", until the matching conditional
|
"<code><![</code>" and ends "<code>]]></code>", until the matching conditional
|
||||||
section end is found. Parameter entity references are not recognized in this
|
section end is found. Parameter entity references are not recognized in this
|
||||||
process.</span></p>
|
process.</span></p>
|
||||||
<p>If the keyword of the conditional section is a parameter-entity reference,
|
<p>If the keyword of the conditional section is a parameter-entity reference,
|
||||||
@ -1319,10 +1319,10 @@ set, for example one not directly accessible from available input devices.]</p>
|
|||||||
<div class="constraint"><p class="prefix"><a name="wf-Legalchar"></a><b>Well-formedness constraint: Legal Character</b></p><p>Characters referred
|
<div class="constraint"><p class="prefix"><a name="wf-Legalchar"></a><b>Well-formedness constraint: Legal Character</b></p><p>Characters referred
|
||||||
to using character references must match the production for <a title="" href="#NT-Char">Char</a>.</p>
|
to using character references must match the production for <a title="" href="#NT-Char">Char</a>.</p>
|
||||||
</div>
|
</div>
|
||||||
<p>If the character reference begins with "<code>&#x</code>",
|
<p>If the character reference begins with "<code>&#x</code>",
|
||||||
the digits and letters up to the terminating <code>;</code> provide a hexadecimal
|
the digits and letters up to the terminating <code>;</code> provide a hexadecimal
|
||||||
representation of the character's code point in ISO/IEC 10646. If it begins
|
representation of the character's code point in ISO/IEC 10646. If it begins
|
||||||
just with "<code>&#</code>", the digits up to the terminating <code>;</code>
|
just with "<code>&#</code>", the digits up to the terminating <code>;</code>
|
||||||
provide a decimal representation of the character's code point.</p>
|
provide a decimal representation of the character's code point.</p>
|
||||||
<p>[<a name="dt-entref" title="Entity Reference">Definition</a>: An <b>entity reference</b>
|
<p>[<a name="dt-entref" title="Entity Reference">Definition</a>: An <b>entity reference</b>
|
||||||
refers to the content of a named entity.] [<a name="dt-GERef" title="General Entity Reference">Definition</a>: References to parsed general entities use
|
refers to the content of a named entity.] [<a name="dt-GERef" title="General Entity Reference">Definition</a>: References to parsed general entities use
|
||||||
@ -1332,7 +1332,7 @@ use percent-sign (<code>%</code>) and semicolon (<code>;</code>) as delimiters.]
|
|||||||
<h5>Entity Reference</h5><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td><a name="NT-Reference"></a>[67]<5D><><EFBFBD></td><td><code>Reference</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code><a href="#NT-EntityRef">EntityRef</a> | <a href="#NT-CharRef">CharRef</a></code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-EntityRef"></a>[68]<5D><><EFBFBD></td><td><code>EntityRef</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'&' <a href="#NT-Name">Name</a> ';'</code></td><xsltdebug></xsltdebug><td><a href="#wf-entdeclared">[WFC: Entity Declared]</a></td></tr><tr valign="baseline"><td></td><td></td><td></td><td></td><td><a href="#vc-entdeclared">[VC: Entity Declared]</a></td></tr><tr valign="baseline"><td></td><td></td><td></td><td></td><td><a href="#textent">[WFC: Parsed Entity]</a></td></tr><tr valign="baseline"><td></td><td></td><td></td><td></td><td><a href="#norecursion">[WFC: No Recursion]</a></td></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-PEReference"></a>[69]<5D><><EFBFBD></td><td><code>PEReference</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'%' <a href="#NT-Name">Name</a> ';'</code></td><xsltdebug></xsltdebug><td><a href="#vc-entdeclared">[VC: Entity Declared]</a></td></tr><tr valign="baseline"><td></td><td></td><td></td><td></td><td><a href="#norecursion">[WFC: No Recursion]</a></td></tr><tr valign="baseline"><td></td><td></td><td></td><td></td><td><a href="#indtd">[WFC: In DTD]</a></td></tr></tbody></table>
|
<h5>Entity Reference</h5><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td><a name="NT-Reference"></a>[67]<5D><><EFBFBD></td><td><code>Reference</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code><a href="#NT-EntityRef">EntityRef</a> | <a href="#NT-CharRef">CharRef</a></code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-EntityRef"></a>[68]<5D><><EFBFBD></td><td><code>EntityRef</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'&' <a href="#NT-Name">Name</a> ';'</code></td><xsltdebug></xsltdebug><td><a href="#wf-entdeclared">[WFC: Entity Declared]</a></td></tr><tr valign="baseline"><td></td><td></td><td></td><td></td><td><a href="#vc-entdeclared">[VC: Entity Declared]</a></td></tr><tr valign="baseline"><td></td><td></td><td></td><td></td><td><a href="#textent">[WFC: Parsed Entity]</a></td></tr><tr valign="baseline"><td></td><td></td><td></td><td></td><td><a href="#norecursion">[WFC: No Recursion]</a></td></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-PEReference"></a>[69]<5D><><EFBFBD></td><td><code>PEReference</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'%' <a href="#NT-Name">Name</a> ';'</code></td><xsltdebug></xsltdebug><td><a href="#vc-entdeclared">[VC: Entity Declared]</a></td></tr><tr valign="baseline"><td></td><td></td><td></td><td></td><td><a href="#norecursion">[WFC: No Recursion]</a></td></tr><tr valign="baseline"><td></td><td></td><td></td><td></td><td><a href="#indtd">[WFC: In DTD]</a></td></tr></tbody></table>
|
||||||
<div class="constraint"><p class="prefix"><a name="wf-entdeclared"></a><b>Well-formedness constraint: Entity Declared</b></p><p>In a document
|
<div class="constraint"><p class="prefix"><a name="wf-entdeclared"></a><b>Well-formedness constraint: Entity Declared</b></p><p>In a document
|
||||||
without any DTD, a document with only an internal DTD subset which contains
|
without any DTD, a document with only an internal DTD subset which contains
|
||||||
no parameter entity references, or a document with "<code>standalone='yes'</code>", <span class="diff-chg"><a href="http://www.w3.org/XML/xml-19980210-errata#E34">[E34]</a>for
|
no parameter entity references, or a document with "<code>standalone='yes'</code>", <span class="diff-chg"><a href="http://www.w3.org/XML/xml-19980210-errata#E34">[E34]</a>for
|
||||||
an entity reference that does not occur within the external subset or a parameter
|
an entity reference that does not occur within the external subset or a parameter
|
||||||
entity, the <a href="#NT-Name">Name</a> given in the entity reference must <a title="match" href="#dt-match">match</a> that in an <a href="#sec-entity-decl"><cite>entity
|
entity, the <a href="#NT-Name">Name</a> given in the entity reference must <a title="match" href="#dt-match">match</a> that in an <a href="#sec-entity-decl"><cite>entity
|
||||||
declaration</cite></a> that does not occur within the external subset or a
|
declaration</cite></a> that does not occur within the external subset or a
|
||||||
@ -1352,7 +1352,7 @@ the rule that an entity must be declared is a well-formedness constraint only
|
|||||||
if <a href="#sec-rmd"><cite>standalone='yes'</cite></a>.</p>
|
if <a href="#sec-rmd"><cite>standalone='yes'</cite></a>.</p>
|
||||||
</div>
|
</div>
|
||||||
<div class="constraint"><p class="prefix"><a name="vc-entdeclared"></a><b>Validity constraint: Entity Declared</b></p><p>In a document with
|
<div class="constraint"><p class="prefix"><a name="vc-entdeclared"></a><b>Validity constraint: Entity Declared</b></p><p>In a document with
|
||||||
an external subset or external parameter entities with "<code>standalone='no'</code>",
|
an external subset or external parameter entities with "<code>standalone='no'</code>",
|
||||||
the <a href="#NT-Name">Name</a> given in the entity reference must <a title="match" href="#dt-match">match</a> that in an <a href="#sec-entity-decl"><cite>entity
|
the <a href="#NT-Name">Name</a> given in the entity reference must <a title="match" href="#dt-match">match</a> that in an <a href="#sec-entity-decl"><cite>entity
|
||||||
declaration</cite></a>. For interoperability, valid documents should declare
|
declaration</cite></a>. For interoperability, valid documents should declare
|
||||||
the entities <code>amp</code>,
|
the entities <code>amp</code>,
|
||||||
@ -1382,9 +1382,9 @@ only appear in the <a title="Document Type Declaration" href="#dt-doctype">DTD</
|
|||||||
This document was prepared on &docdate; and
|
This document was prepared on &docdate; and
|
||||||
is classified &security-level;.</pre></td></tr></table>
|
is classified &security-level;.</pre></td></tr></table>
|
||||||
<p>Example of a parameter-entity reference:</p>
|
<p>Example of a parameter-entity reference:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!-- declare the parameter entity "ISOLat2"... -->
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!-- declare the parameter entity "ISOLat2"... -->
|
||||||
<!ENTITY % ISOLat2
|
<!ENTITY % ISOLat2
|
||||||
SYSTEM "http://www.xml.com/iso/isolat2-xml.entities" >
|
SYSTEM "http://www.xml.com/iso/isolat2-xml.entities" >
|
||||||
<!-- ... now reference it. -->
|
<!-- ... now reference it. -->
|
||||||
%ISOLat2;</pre></td></tr></table>
|
%ISOLat2;</pre></td></tr></table>
|
||||||
</div>
|
</div>
|
||||||
@ -1419,8 +1419,8 @@ Note that some processing of entity and character references in the <a title="Li
|
|||||||
the correct <a title="Replacement Text" href="#dt-repltext">replacement text</a>: see <a href="#intern-replacement"><b>4.5 Construction of Internal Entity Replacement Text</b></a>.</p>
|
the correct <a title="Replacement Text" href="#dt-repltext">replacement text</a>: see <a href="#intern-replacement"><b>4.5 Construction of Internal Entity Replacement Text</b></a>.</p>
|
||||||
<p>An internal entity is a <a title="Text Entity" href="#dt-parsedent">parsed entity</a>.</p>
|
<p>An internal entity is a <a title="Text Entity" href="#dt-parsedent">parsed entity</a>.</p>
|
||||||
<p>Example of an internal entity declaration:</p>
|
<p>Example of an internal entity declaration:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY Pub-Status "This is a pre-release of the
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY Pub-Status "This is a pre-release of the
|
||||||
specification."></pre></td></tr></table>
|
specification."></pre></td></tr></table>
|
||||||
</div>
|
</div>
|
||||||
<div class="div3">
|
<div class="div3">
|
||||||
|
|
||||||
@ -1475,12 +1475,12 @@ single space characters (#x20), and leading and trailing white space must
|
|||||||
be removed.</p>
|
be removed.</p>
|
||||||
<p>Examples of external entity declarations:</p>
|
<p>Examples of external entity declarations:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY open-hatch
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY open-hatch
|
||||||
SYSTEM "http://www.textuality.com/boilerplate/OpenHatch.xml">
|
SYSTEM "http://www.textuality.com/boilerplate/OpenHatch.xml">
|
||||||
<!ENTITY open-hatch
|
<!ENTITY open-hatch
|
||||||
PUBLIC "-//Textuality//TEXT Standard open-hatch boilerplate//EN"
|
PUBLIC "-//Textuality//TEXT Standard open-hatch boilerplate//EN"
|
||||||
"http://www.textuality.com/boilerplate/OpenHatch.xml">
|
"http://www.textuality.com/boilerplate/OpenHatch.xml">
|
||||||
<!ENTITY hatch-pic
|
<!ENTITY hatch-pic
|
||||||
SYSTEM "../grafix/OpenHatch.gif"
|
SYSTEM "../grafix/OpenHatch.gif"
|
||||||
NDATA gif ></pre></td></tr></table>
|
NDATA gif ></pre></td></tr></table>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
@ -1522,8 +1522,8 @@ can begin in one entity and end in another.</p>
|
|||||||
<h4><a name="charencoding"></a>4.3.3 Character Encoding in Entities</h4>
|
<h4><a name="charencoding"></a>4.3.3 Character Encoding in Entities</h4>
|
||||||
<p>Each external parsed entity in an XML document may use a different encoding
|
<p>Each external parsed entity in an XML document may use a different encoding
|
||||||
for its characters. All XML processors must be able to read entities in <span class="diff-chg"><a href="http://www.w3.org/XML/xml-19980210-errata#E56">[E56]</a>both
|
for its characters. All XML processors must be able to read entities in <span class="diff-chg"><a href="http://www.w3.org/XML/xml-19980210-errata#E56">[E56]</a>both
|
||||||
the UTF-8 and UTF-16 encodings.</span> <span class="diff-add"><a href="http://www.w3.org/XML/xml-19980210-errata#E77">[E77]</a>The terms "UTF-8"
|
the UTF-8 and UTF-16 encodings.</span> <span class="diff-add"><a href="http://www.w3.org/XML/xml-19980210-errata#E77">[E77]</a>The terms "UTF-8"
|
||||||
and "UTF-16" in this specification do not apply to character
|
and "UTF-16" in this specification do not apply to character
|
||||||
encodings with any other labels, even if the encodings or labels are very
|
encodings with any other labels, even if the encodings or labels are very
|
||||||
similar to UTF-8 or UTF-16.</span></p>
|
similar to UTF-8 or UTF-16.</span></p>
|
||||||
<p>Entities encoded in UTF-16 must begin with the Byte Order Mark described
|
<p>Entities encoded in UTF-16 must begin with the Byte Order Mark described
|
||||||
@ -1544,25 +1544,25 @@ must begin with a text declaration <span class="diff-add">(see <a href="#sec-Tex
|
|||||||
an encoding declaration:</p>
|
an encoding declaration:</p>
|
||||||
|
|
||||||
<h5>Encoding Declaration</h5><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td><a name="NT-EncodingDecl"></a>[80]<5D><><EFBFBD></td><td><code>EncodingDecl</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code><a href="#NT-S">S</a> 'encoding' <a href="#NT-Eq">Eq</a>
|
<h5>Encoding Declaration</h5><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td><a name="NT-EncodingDecl"></a>[80]<5D><><EFBFBD></td><td><code>EncodingDecl</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code><a href="#NT-S">S</a> 'encoding' <a href="#NT-Eq">Eq</a>
|
||||||
('"' <a href="#NT-EncName">EncName</a> '"' | "'" <a href="#NT-EncName">EncName</a>
|
('"' <a href="#NT-EncName">EncName</a> '"' | "'" <a href="#NT-EncName">EncName</a>
|
||||||
"'" ) </code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-EncName"></a>[81]<5D><><EFBFBD></td><td><code>EncName</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>[A-Za-z] ([A-Za-z0-9._] | '-')*</code></td><xsltdebug></xsltdebug><td><i>/* Encoding
|
"'" ) </code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-EncName"></a>[81]<5D><><EFBFBD></td><td><code>EncName</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>[A-Za-z] ([A-Za-z0-9._] | '-')*</code></td><xsltdebug></xsltdebug><td><i>/* Encoding
|
||||||
name contains only Latin characters */</i></td></tr></tbody></table>
|
name contains only Latin characters */</i></td></tr></tbody></table>
|
||||||
<p>In the <a title="Document Entity" href="#dt-docent">document entity</a>, the encoding
|
<p>In the <a title="Document Entity" href="#dt-docent">document entity</a>, the encoding
|
||||||
declaration is part of the <a title="XML Declaration" href="#dt-xmldecl">XML declaration</a>.
|
declaration is part of the <a title="XML Declaration" href="#dt-xmldecl">XML declaration</a>.
|
||||||
The <a href="#NT-EncName">EncName</a> is the name of the encoding used.</p>
|
The <a href="#NT-EncName">EncName</a> is the name of the encoding used.</p>
|
||||||
|
|
||||||
<p>In an encoding declaration, the values "<code>UTF-8</code>", "<code>UTF-16</code>", "<code>ISO-10646-UCS-2</code>", and "<code>ISO-10646-UCS-4</code>" should be used
|
<p>In an encoding declaration, the values "<code>UTF-8</code>", "<code>UTF-16</code>", "<code>ISO-10646-UCS-2</code>", and "<code>ISO-10646-UCS-4</code>" should be used
|
||||||
for the various encodings and transformations of Unicode / ISO/IEC 10646,
|
for the various encodings and transformations of Unicode / ISO/IEC 10646,
|
||||||
the values "<code>ISO-8859-1</code>", "<code>ISO-8859-2</code>",
|
the values "<code>ISO-8859-1</code>", "<code>ISO-8859-2</code>",
|
||||||
... <a href="http://www.w3.org/XML/xml-19980210-errata#E106">[E106]</a><span class="diff-chg">"<code>ISO-8859-</code><var>n</var>" (where <var>n</var>
|
... <a href="http://www.w3.org/XML/xml-19980210-errata#E106">[E106]</a><span class="diff-chg">"<code>ISO-8859-</code><var>n</var>" (where <var>n</var>
|
||||||
is the part number)</span> should be used for the parts of ISO 8859, and
|
is the part number)</span> should be used for the parts of ISO 8859, and
|
||||||
the values "<code>ISO-2022-JP</code>", "<code>Shift_JIS</code>",
|
the values "<code>ISO-2022-JP</code>", "<code>Shift_JIS</code>",
|
||||||
and "<code>EUC-JP</code>" should be used for the various encoded
|
and "<code>EUC-JP</code>" should be used for the various encoded
|
||||||
forms of JIS X-0208-1997. <span class="diff-chg"><a href="http://www.w3.org/XML/xml-19980210-errata#E57">[E57]</a>It
|
forms of JIS X-0208-1997. <span class="diff-chg"><a href="http://www.w3.org/XML/xml-19980210-errata#E57">[E57]</a>It
|
||||||
is recommended that character encodings registered (as <em>charset</em>s)
|
is recommended that character encodings registered (as <em>charset</em>s)
|
||||||
with the Internet Assigned Numbers Authority <span class="diff-chg"><a href="http://www.w3.org/XML/xml-19980210-errata#E58">[E58]</a><a href="#IANA">[IANA-CHARSETS]</a></span>,
|
with the Internet Assigned Numbers Authority <span class="diff-chg"><a href="http://www.w3.org/XML/xml-19980210-errata#E58">[E58]</a><a href="#IANA">[IANA-CHARSETS]</a></span>,
|
||||||
other than those just listed, be referred to using their registered names;
|
other than those just listed, be referred to using their registered names;
|
||||||
other encodings should use names starting with an "x-" prefix.
|
other encodings should use names starting with an "x-" prefix.
|
||||||
XML processors should match character encoding names in a case-insensitive
|
XML processors should match character encoding names in a case-insensitive
|
||||||
way and should either interpret an IANA-registered name as the encoding registered
|
way and should either interpret an IANA-registered name as the encoding registered
|
||||||
at IANA for that name or treat it as unknown (processors are, of course, not
|
at IANA for that name or treat it as unknown (processors are, of course, not
|
||||||
@ -1674,8 +1674,8 @@ the replacement text of entities used to escape markup delimiters (the entities
|
|||||||
<code>gt</code>,
|
<code>gt</code>,
|
||||||
<code>apos</code>,
|
<code>apos</code>,
|
||||||
<code>quot</code>)
|
<code>quot</code>)
|
||||||
is always treated as data</span>. (The string "<code>AT&amp;T;</code>"
|
is always treated as data</span>. (The string "<code>AT&amp;T;</code>"
|
||||||
expands to "<code>AT&T;</code>" and the remaining ampersand
|
expands to "<code>AT&T;</code>" and the remaining ampersand
|
||||||
is not recognized as an entity-reference delimiter.) A character reference
|
is not recognized as an entity-reference delimiter.) A character reference
|
||||||
is <b>included</b> when the indicated character is processed in place
|
is <b>included</b> when the indicated character is processed in place
|
||||||
of the reference itself. </p>
|
of the reference itself. </p>
|
||||||
@ -1723,10 +1723,10 @@ the location the reference was recognized, except that a single or double
|
|||||||
quote character in the replacement text is always treated as a normal data
|
quote character in the replacement text is always treated as a normal data
|
||||||
character and will not terminate the literal. For example, this is well-formed:</p>
|
character and will not terminate the literal. For example, this is well-formed:</p>
|
||||||
<div class="diff-chg"><table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td class="diff-chg"><pre><!-- <a href="http://www.w3.org/XML/xml-19980210-errata#E4">[E4]</a> -->
|
<div class="diff-chg"><table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td class="diff-chg"><pre><!-- <a href="http://www.w3.org/XML/xml-19980210-errata#E4">[E4]</a> -->
|
||||||
<!ENTITY % YN '"Yes"' >
|
<!ENTITY % YN '"Yes"' >
|
||||||
<!ENTITY WhatHeSaid "He said %YN;" ></pre></td></tr></table></div>
|
<!ENTITY WhatHeSaid "He said %YN;" ></pre></td></tr></table></div>
|
||||||
<p>while this is not:</p>
|
<p>while this is not:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY EndAttr "27'" >
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY EndAttr "27'" >
|
||||||
<element attribute='a-&EndAttr;></pre></td></tr></table>
|
<element attribute='a-&EndAttr;></pre></td></tr></table>
|
||||||
</div>
|
</div>
|
||||||
<div class="div3">
|
<div class="div3">
|
||||||
@ -1773,16 +1773,16 @@ text</em> of any parameter entities referred to, and must contain the character
|
|||||||
referred to, in place of any character references in the literal entity value;
|
referred to, in place of any character references in the literal entity value;
|
||||||
however, general-entity references must be left as-is, unexpanded. For example,
|
however, general-entity references must be left as-is, unexpanded. For example,
|
||||||
given the following declarations:</p>
|
given the following declarations:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY % pub "&#xc9;ditions Gallimard" >
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY % pub "&#xc9;ditions Gallimard" >
|
||||||
<!ENTITY rights "All rights reserved" >
|
<!ENTITY rights "All rights reserved" >
|
||||||
<!ENTITY book "La Peste: Albert Camus,
|
<!ENTITY book "La Peste: Albert Camus,
|
||||||
&#xA9; 1947 %pub;. &rights;" ></pre></td></tr></table>
|
&#xA9; 1947 %pub;. &rights;" ></pre></td></tr></table>
|
||||||
<p>then the replacement text for the entity "<code>book</code>"
|
<p>then the replacement text for the entity "<code>book</code>"
|
||||||
is:</p>
|
is:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre>La Peste: Albert Camus,
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre>La Peste: Albert Camus,
|
||||||
<EFBFBD> 1947 <20>ditions Gallimard. &rights;</pre></td></tr></table>
|
<EFBFBD> 1947 <20>ditions Gallimard. &rights;</pre></td></tr></table>
|
||||||
<p>The general-entity reference "<code>&rights;</code>" would
|
<p>The general-entity reference "<code>&rights;</code>" would
|
||||||
be expanded should the reference "<code>&book;</code>" appear
|
be expanded should the reference "<code>&book;</code>" appear
|
||||||
in the document's content or an attribute value.</p>
|
in the document's content or an attribute value.</p>
|
||||||
<p>These simple rules may have complex interactions; for a detailed discussion
|
<p>These simple rules may have complex interactions; for a detailed discussion
|
||||||
of a difficult example, see <a href="#sec-entexpand"><b>D Expansion of Entity and Character References</b></a>.</p>
|
of a difficult example, see <a href="#sec-entexpand"><b>D Expansion of Entity and Character References</b></a>.</p>
|
||||||
@ -1799,7 +1799,7 @@ other delimiters. A set of general entities (<code>amp</code>,
|
|||||||
<code>quot</code>) is specified for
|
<code>quot</code>) is specified for
|
||||||
this purpose. Numeric character references may also be used; they are expanded
|
this purpose. Numeric character references may also be used; they are expanded
|
||||||
immediately when recognized and must be treated as character data, so the
|
immediately when recognized and must be treated as character data, so the
|
||||||
numeric character references "<code>&#60;</code>" and "<code>&#38;</code>"
|
numeric character references "<code>&#60;</code>" and "<code>&#38;</code>"
|
||||||
may be used to escape <code><</code> and <code>&</code> when they occur
|
may be used to escape <code><</code> and <code>&</code> when they occur
|
||||||
in character data.]</p>
|
in character data.]</p>
|
||||||
<p>All XML processors must recognize these entities whether they are declared
|
<p>All XML processors must recognize these entities whether they are declared
|
||||||
@ -1815,13 +1815,13 @@ or <code>quot</code> are declared, they must be declared as internal entities
|
|||||||
whose replacement text is the single character being escaped (or a character
|
whose replacement text is the single character being escaped (or a character
|
||||||
reference to that character; the double escaping here is unnecessary but harmless).
|
reference to that character; the double escaping here is unnecessary but harmless).
|
||||||
For example:</span></p>
|
For example:</span></p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY lt "&#38;#60;">
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY lt "&#38;#60;">
|
||||||
<!ENTITY gt "&#62;">
|
<!ENTITY gt "&#62;">
|
||||||
<!ENTITY amp "&#38;#38;">
|
<!ENTITY amp "&#38;#38;">
|
||||||
<!ENTITY apos "&#39;">
|
<!ENTITY apos "&#39;">
|
||||||
<!ENTITY quot "&#34;"></pre></td></tr></table>
|
<!ENTITY quot "&#34;"></pre></td></tr></table>
|
||||||
<div class="diff-del"><p>Note that the <code><</code> and <code>&</code> characters
|
<div class="diff-del"><p>Note that the <code><</code> and <code>&</code> characters
|
||||||
in the declarations of "<code>lt</code>" and "<code>amp</code>"
|
in the declarations of "<code>lt</code>" and "<code>amp</code>"
|
||||||
are doubly escaped to meet the requirement that entity replacement be well-formed.</p></div>
|
are doubly escaped to meet the requirement that entity replacement be well-formed.</p></div>
|
||||||
</div>
|
</div>
|
||||||
<div class="div2">
|
<div class="div2">
|
||||||
@ -1890,7 +1890,7 @@ they do <em>not</em> read; that is to say, they must use the information
|
|||||||
in those declarations to <a href="#AVNormalize"><cite>normalize</cite></a>
|
in those declarations to <a href="#AVNormalize"><cite>normalize</cite></a>
|
||||||
attribute values, <a href="#included"><cite>include</cite></a> the replacement
|
attribute values, <a href="#included"><cite>include</cite></a> the replacement
|
||||||
text of internal entities, and supply <a href="#sec-attr-defaults"><cite>default
|
text of internal entities, and supply <a href="#sec-attr-defaults"><cite>default
|
||||||
attribute values</cite></a>.] <span class="diff-add"><a href="http://www.w3.org/XML/xml-19980210-errata#E33">[E33]</a>Except when <code>standalone="yes"</code>, </span>they
|
attribute values</cite></a>.] <span class="diff-add"><a href="http://www.w3.org/XML/xml-19980210-errata#E33">[E33]</a>Except when <code>standalone="yes"</code>, </span>they
|
||||||
must not <a title="Process Declarations" href="#dt-use-mdecl">process</a> <a title="entity declaration" href="#dt-entdecl">entity
|
must not <a title="Process Declarations" href="#dt-use-mdecl">process</a> <a title="entity declaration" href="#dt-entdecl">entity
|
||||||
declarations</a> or <a title="Attribute-List Declaration" href="#dt-attdecl">attribute-list declarations</a>
|
declarations</a> or <a title="Attribute-List Declaration" href="#dt-attdecl">attribute-list declarations</a>
|
||||||
encountered after a reference to a parameter entity that is not read, since
|
encountered after a reference to a parameter entity that is not read, since
|
||||||
@ -1964,7 +1964,7 @@ indicated.</p>
|
|||||||
<p>matches any <span class="diff-chg"><a href="http://www.w3.org/XML/xml-19980210-errata#E93">[E93]</a><a href="#NT-Char">Char</a></span> with a value not among the characters given. <span class="diff-add"><a href="http://www.w3.org/XML/xml-19980210-errata#E3">[E3]</a>Enumerations
|
<p>matches any <span class="diff-chg"><a href="http://www.w3.org/XML/xml-19980210-errata#E93">[E93]</a><a href="#NT-Char">Char</a></span> with a value not among the characters given. <span class="diff-add"><a href="http://www.w3.org/XML/xml-19980210-errata#E3">[E3]</a>Enumerations
|
||||||
and ranges of forbidden values can be mixed in one set of brackets.</span></p>
|
and ranges of forbidden values can be mixed in one set of brackets.</span></p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt class="label"><code>"string"</code></dt>
|
<dt class="label"><code>"string"</code></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>matches a literal string <a title="match" href="#dt-match">matching</a> that
|
<p>matches a literal string <a title="match" href="#dt-match">matching</a> that
|
||||||
given inside the double quotes.</p>
|
given inside the double quotes.</p>
|
||||||
@ -2253,8 +2253,8 @@ the categories Mc, Me, Mn, Lm, or Nd.</p></li>
|
|||||||
<li><p>Characters in the compatibility area (i.e. with character code greater
|
<li><p>Characters in the compatibility area (i.e. with character code greater
|
||||||
than #xF900 and less than #xFFFE) are not allowed in XML names.</p></li>
|
than #xF900 and less than #xFFFE) are not allowed in XML names.</p></li>
|
||||||
<li><p>Characters which have a font or compatibility decomposition (i.e.
|
<li><p>Characters which have a font or compatibility decomposition (i.e.
|
||||||
those with a "compatibility formatting tag" in field 5 of the
|
those with a "compatibility formatting tag" in field 5 of the
|
||||||
database -- marked by field 5 beginning with a "<") are not
|
database -- marked by field 5 beginning with a "<") are not
|
||||||
allowed.</p></li>
|
allowed.</p></li>
|
||||||
<li><p>The following characters are treated as name-start characters rather
|
<li><p>The following characters are treated as name-start characters rather
|
||||||
than name characters, because the property file classifies them as Alphabetic:
|
than name characters, because the property file classifies them as Alphabetic:
|
||||||
@ -2284,16 +2284,16 @@ restrictions that XML places on documents beyond those of SGML, see <a href="#Cl
|
|||||||
<p>This appendix contains some examples illustrating the sequence of entity-
|
<p>This appendix contains some examples illustrating the sequence of entity-
|
||||||
and character-reference recognition and expansion, as specified in <a href="#entproc"><b>4.4 XML Processor Treatment of Entities and References</b></a>.</p>
|
and character-reference recognition and expansion, as specified in <a href="#entproc"><b>4.4 XML Processor Treatment of Entities and References</b></a>.</p>
|
||||||
<p>If the DTD contains the declaration</p>
|
<p>If the DTD contains the declaration</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY example "<p>An ampersand (&#38;#38;) may be escaped
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY example "<p>An ampersand (&#38;#38;) may be escaped
|
||||||
numerically (&#38;#38;#38;) or with a general entity
|
numerically (&#38;#38;#38;) or with a general entity
|
||||||
(&amp;amp;).</p>" ></pre></td></tr></table>
|
(&amp;amp;).</p>" ></pre></td></tr></table>
|
||||||
<p>then the XML processor will recognize the character references when it
|
<p>then the XML processor will recognize the character references when it
|
||||||
parses the entity declaration, and resolve them before storing the following
|
parses the entity declaration, and resolve them before storing the following
|
||||||
string as the value of the entity "<code>example</code>":</p>
|
string as the value of the entity "<code>example</code>":</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><p>An ampersand (&#38;) may be escaped
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><p>An ampersand (&#38;) may be escaped
|
||||||
numerically (&#38;#38;) or with a general entity
|
numerically (&#38;#38;) or with a general entity
|
||||||
(&amp;amp;).</p></pre></td></tr></table>
|
(&amp;amp;).</p></pre></td></tr></table>
|
||||||
<p>A reference in the document to "<code>&example;</code>"
|
<p>A reference in the document to "<code>&example;</code>"
|
||||||
will cause the text to be reparsed, at which time the start- and end-tags
|
will cause the text to be reparsed, at which time the start- and end-tags
|
||||||
of the <code>p</code> element will be recognized and the three references will
|
of the <code>p</code> element will be recognized and the three references will
|
||||||
be recognized and expanded, resulting in a <code>p</code> element with the following
|
be recognized and expanded, resulting in a <code>p</code> element with the following
|
||||||
@ -2307,30 +2307,30 @@ In the following example, the line numbers are solely for reference.</p>
|
|||||||
2 <!DOCTYPE test [
|
2 <!DOCTYPE test [
|
||||||
3 <!ELEMENT test (#PCDATA) >
|
3 <!ELEMENT test (#PCDATA) >
|
||||||
4 <!ENTITY % xx '&#37;zz;'>
|
4 <!ENTITY % xx '&#37;zz;'>
|
||||||
5 <!ENTITY % zz '&#60;!ENTITY tricky "error-prone" >' >
|
5 <!ENTITY % zz '&#60;!ENTITY tricky "error-prone" >' >
|
||||||
6 %xx;
|
6 %xx;
|
||||||
7 ]>
|
7 ]>
|
||||||
8 <test>This sample shows a &tricky; method.</test></pre></td></tr></table>
|
8 <test>This sample shows a &tricky; method.</test></pre></td></tr></table>
|
||||||
<p>This produces the following:</p>
|
<p>This produces the following:</p>
|
||||||
<ul>
|
<ul>
|
||||||
<li><p>in line 4, the reference to character 37 is expanded immediately,
|
<li><p>in line 4, the reference to character 37 is expanded immediately,
|
||||||
and the parameter entity "<code>xx</code>" is stored in the symbol
|
and the parameter entity "<code>xx</code>" is stored in the symbol
|
||||||
table with the value "<code>%zz;</code>". Since the replacement
|
table with the value "<code>%zz;</code>". Since the replacement
|
||||||
text is not rescanned, the reference to parameter entity "<code>zz</code>"
|
text is not rescanned, the reference to parameter entity "<code>zz</code>"
|
||||||
is not recognized. (And it would be an error if it were, since "<code>zz</code>"
|
is not recognized. (And it would be an error if it were, since "<code>zz</code>"
|
||||||
is not yet declared.)</p></li>
|
is not yet declared.)</p></li>
|
||||||
<li><p>in line 5, the character reference "<code>&#60;</code>"
|
<li><p>in line 5, the character reference "<code>&#60;</code>"
|
||||||
is expanded immediately and the parameter entity "<code>zz</code>"
|
is expanded immediately and the parameter entity "<code>zz</code>"
|
||||||
is stored with the replacement text "<code><!ENTITY tricky "error-prone"
|
is stored with the replacement text "<code><!ENTITY tricky "error-prone"
|
||||||
></code>", which is a well-formed entity declaration.</p></li>
|
></code>", which is a well-formed entity declaration.</p></li>
|
||||||
<li><p>in line 6, the reference to "<code>xx</code>" is recognized,
|
<li><p>in line 6, the reference to "<code>xx</code>" is recognized,
|
||||||
and the replacement text of "<code>xx</code>" (namely "<code>%zz;</code>")
|
and the replacement text of "<code>xx</code>" (namely "<code>%zz;</code>")
|
||||||
is parsed. The reference to "<code>zz</code>" is recognized in
|
is parsed. The reference to "<code>zz</code>" is recognized in
|
||||||
its turn, and its replacement text ("<code><!ENTITY tricky "error-prone"
|
its turn, and its replacement text ("<code><!ENTITY tricky "error-prone"
|
||||||
></code>") is parsed. The general entity "<code>tricky</code>"
|
></code>") is parsed. The general entity "<code>tricky</code>"
|
||||||
has now been declared, with the replacement text "<code>error-prone</code>".</p>
|
has now been declared, with the replacement text "<code>error-prone</code>".</p>
|
||||||
</li>
|
</li>
|
||||||
<li><p>in line 8, the reference to the general entity "<code>tricky</code>"
|
<li><p>in line 8, the reference to the general entity "<code>tricky</code>"
|
||||||
is recognized, and it is expanded, so the full content of the <code>test</code>
|
is recognized, and it is expanded, so the full content of the <code>test</code>
|
||||||
element is the self-describing (and ungrammatical) string <em>This sample
|
element is the self-describing (and ungrammatical) string <em>This sample
|
||||||
shows a error-prone method.</em></p></li>
|
shows a error-prone method.</em></p></li>
|
||||||
@ -2342,7 +2342,7 @@ shows a error-prone method.</em></p></li>
|
|||||||
<p><span class="diff-chg"><a href="http://www.w3.org/XML/xml-19980210-errata#E102">[E102]</a>As
|
<p><span class="diff-chg"><a href="http://www.w3.org/XML/xml-19980210-errata#E102">[E102]</a>As
|
||||||
noted in <a href="#sec-element-content"><b>3.2.1 Element Content</b></a>, it is required that content
|
noted in <a href="#sec-element-content"><b>3.2.1 Element Content</b></a>, it is required that content
|
||||||
models in element type declarations be deterministic. This requirement is <a title="For Compatibility" href="#dt-compat">for compatibility</a> with SGML (which calls deterministic
|
models in element type declarations be deterministic. This requirement is <a title="For Compatibility" href="#dt-compat">for compatibility</a> with SGML (which calls deterministic
|
||||||
content models "unambiguous");</span> XML processors built
|
content models "unambiguous");</span> XML processors built
|
||||||
using SGML systems may flag non-deterministic content models as errors.</p>
|
using SGML systems may flag non-deterministic content models as errors.</p>
|
||||||
<p>For example, the content model <code>((b, c) | (b, d))</code> is non-deterministic,
|
<p>For example, the content model <code>((b, c) | (b, d))</code> is non-deterministic,
|
||||||
because given an initial <code>b</code> the <span class="diff-chg"><a href="http://www.w3.org/XML/xml-19980210-errata#E95">[E95]</a>XML processor</span>
|
because given an initial <code>b</code> the <span class="diff-chg"><a href="http://www.w3.org/XML/xml-19980210-errata#E95">[E95]</a>XML processor</span>
|
||||||
@ -2390,9 +2390,9 @@ encoding information and </span>not in UTF-8 or UTF-16 <span class="diff-chg">en
|
|||||||
begin with an XML encoding declaration, in which the first characters must
|
begin with an XML encoding declaration, in which the first characters must
|
||||||
be '<code><?xml</code>', any conforming processor can detect, after two
|
be '<code><?xml</code>', any conforming processor can detect, after two
|
||||||
to four octets of input, which of the following cases apply. In reading this
|
to four octets of input, which of the following cases apply. In reading this
|
||||||
list, it may help to know that in UCS-4, '<' is "<code>#x0000003C</code>"
|
list, it may help to know that in UCS-4, '<' is "<code>#x0000003C</code>"
|
||||||
and '?' is "<code>#x0000003F</code>", and the Byte Order Mark
|
and '?' is "<code>#x0000003F</code>", and the Byte Order Mark
|
||||||
required of UTF-16 data streams is "<code>#xFEFF</code>". <span class="diff-add">The notation <var>##</var> is used to denote any byte value except <span class="diff-chg">that two consecutive <var>##</var>s cannot be both 00</span>.</span></p>
|
required of UTF-16 data streams is "<code>#xFEFF</code>". <span class="diff-add">The notation <var>##</var> is used to denote any byte value except <span class="diff-chg">that two consecutive <var>##</var>s cannot be both 00</span>.</span></p>
|
||||||
<div class="diff-add"><p>With a Byte Order Mark:</p></div>
|
<div class="diff-add"><p>With a Byte Order Mark:</p></div>
|
||||||
<div class="diff-add"><table border="1" frame="border"><tbody><tr><td colspan="1" rowspan="1"><code>00 00 FE
|
<div class="diff-add"><table border="1" frame="border"><tbody><tr><td colspan="1" rowspan="1"><code>00 00 FE
|
||||||
FF</code></td><td colspan="1" rowspan="1">UCS-4, big-endian machine (1234 order)</td></tr><tr><td colspan="1" rowspan="1"><code>FF
|
FF</code></td><td colspan="1" rowspan="1">UCS-4, big-endian machine (1234 order)</td></tr><tr><td colspan="1" rowspan="1"><code>FF
|
||||||
@ -2574,7 +2574,7 @@ Contact</i>) </li>
|
|||||||
</div></div>
|
</div></div>
|
||||||
<div class="diff-add"><div class="div1">
|
<div class="diff-add"><div class="div1">
|
||||||
|
|
||||||
<h2><a name="id2676581"></a>I Production Notes (Non-Normative)</h2>
|
<h2><a name="id2681697"></a>I Production Notes (Non-Normative)</h2>
|
||||||
<p>This Second Edition was encoded in the <a href="http://www.w3.org/XML/1998/06/xmlspec-v21.dtd">XMLspec
|
<p>This Second Edition was encoded in the <a href="http://www.w3.org/XML/1998/06/xmlspec-v21.dtd">XMLspec
|
||||||
DTD</a> (which has <a href="http://www.w3.org/XML/1998/06/xmlspec-report-v21.htm">documentation</a>
|
DTD</a> (which has <a href="http://www.w3.org/XML/1998/06/xmlspec-report-v21.htm">documentation</a>
|
||||||
available). The HTML versions were produced with a combination of the <a href="http://www.w3.org/XML/1998/06/xmlspec.xsl">xmlspec.xsl</a>, <a href="http://www.w3.org/XML/1998/06/diffspec.xsl">diffspec.xsl</a>,
|
available). The HTML versions were produced with a combination of the <a href="http://www.w3.org/XML/1998/06/xmlspec.xsl">xmlspec.xsl</a>, <a href="http://www.w3.org/XML/1998/06/diffspec.xsl">diffspec.xsl</a>,
|
||||||
|
|||||||
@ -65,7 +65,7 @@ be contacted at <a href="mailto:cmsmcq@w3.org">cmsmcq@w3.org</a>.</p>
|
|||||||
<h2><a name="contents">Table of Contents</a></h2><p class="toc">1 <a href="#sec-intro">Introduction</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>1.1 <a href="#sec-origin-goals">Origin and Goals</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>1.2 <a href="#sec-terminology">Terminology</a><br>2 <a href="#sec-documents">Documents</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.1 <a href="#sec-well-formed">Well-Formed XML Documents</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.2 <a href="#charsets">Characters</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.3 <a href="#sec-common-syn">Common Syntactic Constructs</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.4 <a href="#syntax">Character Data and Markup</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.5 <a href="#sec-comments">Comments</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.6 <a href="#sec-pi">Processing Instructions</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.7 <a href="#sec-cdata-sect">CDATA Sections</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.8 <a href="#sec-prolog-dtd">Prolog and Document Type Declaration</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.9 <a href="#sec-rmd">Standalone Document Declaration</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.10 <a href="#sec-white-space">White Space Handling</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.11 <a href="#sec-line-ends">End-of-Line Handling</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.12 <a href="#sec-lang-tag">Language Identification</a><br>3 <a href="#sec-logical-struct">Logical Structures</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.1 <a href="#sec-starttags">Start-Tags, End-Tags, and Empty-Element Tags</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.2 <a href="#elemdecls">Element Type Declarations</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.2.1 <a href="#sec-element-content">Element Content</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.2.2 <a href="#sec-mixed-content">Mixed Content</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.3 <a href="#attdecls">Attribute-List Declarations</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.3.1 <a href="#sec-attribute-types">Attribute Types</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.3.2 <a href="#sec-attr-defaults">Attribute Defaults</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.3.3 <a href="#AVNormalize">Attribute-Value
|
<h2><a name="contents">Table of Contents</a></h2><p class="toc">1 <a href="#sec-intro">Introduction</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>1.1 <a href="#sec-origin-goals">Origin and Goals</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>1.2 <a href="#sec-terminology">Terminology</a><br>2 <a href="#sec-documents">Documents</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.1 <a href="#sec-well-formed">Well-Formed XML Documents</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.2 <a href="#charsets">Characters</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.3 <a href="#sec-common-syn">Common Syntactic Constructs</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.4 <a href="#syntax">Character Data and Markup</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.5 <a href="#sec-comments">Comments</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.6 <a href="#sec-pi">Processing Instructions</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.7 <a href="#sec-cdata-sect">CDATA Sections</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.8 <a href="#sec-prolog-dtd">Prolog and Document Type Declaration</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.9 <a href="#sec-rmd">Standalone Document Declaration</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.10 <a href="#sec-white-space">White Space Handling</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.11 <a href="#sec-line-ends">End-of-Line Handling</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>2.12 <a href="#sec-lang-tag">Language Identification</a><br>3 <a href="#sec-logical-struct">Logical Structures</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.1 <a href="#sec-starttags">Start-Tags, End-Tags, and Empty-Element Tags</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.2 <a href="#elemdecls">Element Type Declarations</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.2.1 <a href="#sec-element-content">Element Content</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.2.2 <a href="#sec-mixed-content">Mixed Content</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.3 <a href="#attdecls">Attribute-List Declarations</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.3.1 <a href="#sec-attribute-types">Attribute Types</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.3.2 <a href="#sec-attr-defaults">Attribute Defaults</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.3.3 <a href="#AVNormalize">Attribute-Value
|
||||||
Normalization</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.4 <a href="#sec-condition-sect">Conditional Sections</a><br>4 <a href="#sec-physical-struct">Physical Structures</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.1 <a href="#sec-references">Character and Entity References</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.2 <a href="#sec-entity-decl">Entity Declarations</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.2.1 <a href="#sec-internal-ent">Internal Entities</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.2.2 <a href="#sec-external-ent">External Entities</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.3 <a href="#TextEntities">Parsed Entities</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.3.1 <a href="#sec-TextDecl">The Text Declaration</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.3.2 <a href="#wf-entities">Well-Formed Parsed Entities</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.3.3 <a href="#charencoding">Character Encoding in Entities</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4 <a href="#entproc">XML Processor Treatment of Entities and References</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.1 <a href="#not-recognized">Not Recognized</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.2 <a href="#included">Included</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.3 <a href="#include-if-valid">Included If Validating</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.4 <a href="#forbidden">Forbidden</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.5 <a href="#inliteral">Included in Literal</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.6 <a href="#notify">Notify</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.7 <a href="#bypass">Bypassed</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.8 <a href="#as-PE">Included as PE</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.5 <a href="#intern-replacement">Construction of Internal Entity Replacement Text</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.6 <a href="#sec-predefined-ent">Predefined Entities</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.7 <a href="#Notations">Notation Declarations</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.8 <a href="#sec-doc-entity">Document Entity</a><br>5 <a href="#sec-conformance">Conformance</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>5.1 <a href="#proc-types">Validating and Non-Validating Processors</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>5.2 <a href="#safe-behavior">Using XML Processors</a><br>6 <a href="#sec-notation">Notation</a><br></p>
|
Normalization</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>3.4 <a href="#sec-condition-sect">Conditional Sections</a><br>4 <a href="#sec-physical-struct">Physical Structures</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.1 <a href="#sec-references">Character and Entity References</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.2 <a href="#sec-entity-decl">Entity Declarations</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.2.1 <a href="#sec-internal-ent">Internal Entities</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.2.2 <a href="#sec-external-ent">External Entities</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.3 <a href="#TextEntities">Parsed Entities</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.3.1 <a href="#sec-TextDecl">The Text Declaration</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.3.2 <a href="#wf-entities">Well-Formed Parsed Entities</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.3.3 <a href="#charencoding">Character Encoding in Entities</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4 <a href="#entproc">XML Processor Treatment of Entities and References</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.1 <a href="#not-recognized">Not Recognized</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.2 <a href="#included">Included</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.3 <a href="#include-if-valid">Included If Validating</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.4 <a href="#forbidden">Forbidden</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.5 <a href="#inliteral">Included in Literal</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.6 <a href="#notify">Notify</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.7 <a href="#bypass">Bypassed</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.4.8 <a href="#as-PE">Included as PE</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.5 <a href="#intern-replacement">Construction of Internal Entity Replacement Text</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.6 <a href="#sec-predefined-ent">Predefined Entities</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.7 <a href="#Notations">Notation Declarations</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>4.8 <a href="#sec-doc-entity">Document Entity</a><br>5 <a href="#sec-conformance">Conformance</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>5.1 <a href="#proc-types">Validating and Non-Validating Processors</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>5.2 <a href="#safe-behavior">Using XML Processors</a><br>6 <a href="#sec-notation">Notation</a><br></p>
|
||||||
<h3>Appendices</h3><p class="toc">A <a href="#sec-bibliography">References</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>A.1 <a href="#sec-existing-stds">Normative References</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>A.2 <a href="#null">Other References</a><br>B <a href="#CharClasses">Character Classes</a><br>C <a href="#sec-xml-and-sgml">XML and SGML</a> (Non-Normative)<br>D <a href="#sec-entexpand">Expansion of Entity and Character References</a> (Non-Normative)<br>E <a href="#determinism">Deterministic Content Models</a> (Non-Normative)<br>F <a href="#sec-guessing">Autodetection
|
<h3>Appendices</h3><p class="toc">A <a href="#sec-bibliography">References</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>A.1 <a href="#sec-existing-stds">Normative References</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>A.2 <a href="#null">Other References</a><br>B <a href="#CharClasses">Character Classes</a><br>C <a href="#sec-xml-and-sgml">XML and SGML</a> (Non-Normative)<br>D <a href="#sec-entexpand">Expansion of Entity and Character References</a> (Non-Normative)<br>E <a href="#determinism">Deterministic Content Models</a> (Non-Normative)<br>F <a href="#sec-guessing">Autodetection
|
||||||
of Character Encodings</a> (Non-Normative)<br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>F.1 <a href="#sec-guessing-no-ext-info">Detection Without External Encoding Information</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>F.2 <a href="#sec-guessing-with-ext-info">Priorities in the Presence of External Encoding Information</a><br>G <a href="#sec-xml-wg">W3C XML Working Group</a> (Non-Normative)<br>H <a href="#sec-core-wg">W3C XML Core Group</a> (Non-Normative)<br>I <a href="#id2676581">Production Notes</a> (Non-Normative)<br></p></div><hr><div class="body">
|
of Character Encodings</a> (Non-Normative)<br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>F.1 <a href="#sec-guessing-no-ext-info">Detection Without External Encoding Information</a><br><EFBFBD><EFBFBD><EFBFBD><EFBFBD>F.2 <a href="#sec-guessing-with-ext-info">Priorities in the Presence of External Encoding Information</a><br>G <a href="#sec-xml-wg">W3C XML Working Group</a> (Non-Normative)<br>H <a href="#sec-core-wg">W3C XML Core Group</a> (Non-Normative)<br>I <a href="#id2681697">Production Notes</a> (Non-Normative)<br></p></div><hr><div class="body">
|
||||||
<div class="div1">
|
<div class="div1">
|
||||||
|
|
||||||
<h2><a name="sec-intro"></a>1 Introduction</h2>
|
<h2><a name="sec-intro"></a>1 Introduction</h2>
|
||||||
@ -213,7 +213,7 @@ be <a title="Validity" href="#dt-valid">valid</a> if it meets certain further co
|
|||||||
<p>Each XML document has both a logical and a physical structure. Physically,
|
<p>Each XML document has both a logical and a physical structure. Physically,
|
||||||
the document is composed of units called <a title="Entity" href="#dt-entity">entities</a>.
|
the document is composed of units called <a title="Entity" href="#dt-entity">entities</a>.
|
||||||
An entity may <a title="Entity Reference" href="#dt-entref">refer</a> to other entities to
|
An entity may <a title="Entity Reference" href="#dt-entref">refer</a> to other entities to
|
||||||
cause their inclusion in the document. A document begins in a "root"
|
cause their inclusion in the document. A document begins in a "root"
|
||||||
or <a title="Document Entity" href="#dt-docent">document entity</a>. Logically, the document
|
or <a title="Document Entity" href="#dt-docent">document entity</a>. Logically, the document
|
||||||
is composed of declarations, elements, comments, character references, and
|
is composed of declarations, elements, comments, character references, and
|
||||||
processing instructions, all of which are indicated in the document by explicit
|
processing instructions, all of which are indicated in the document by explicit
|
||||||
@ -268,7 +268,7 @@ versions of these standards cited in <a href="#sec-existing-stds"><b>A.1 Normati
|
|||||||
current at the time this document was prepared. New characters may be added
|
current at the time this document was prepared. New characters may be added
|
||||||
to these standards by amendments or new editions. Consequently, XML processors
|
to these standards by amendments or new editions. Consequently, XML processors
|
||||||
must accept any character in the range specified for <a href="#NT-Char">Char</a>.
|
must accept any character in the range specified for <a href="#NT-Char">Char</a>.
|
||||||
The use of "compatibility characters", as defined in section
|
The use of "compatibility characters", as defined in section
|
||||||
6.8 of <a href="#Unicode">[Unicode]</a> (see
|
6.8 of <a href="#Unicode">[Unicode]</a> (see
|
||||||
also D21 in section 3.6 of <a href="#Unicode3">[Unicode3]</a>), is discouraged.]</p>
|
also D21 in section 3.6 of <a href="#Unicode3">[Unicode3]</a>), is discouraged.]</p>
|
||||||
|
|
||||||
@ -299,7 +299,7 @@ are given in <a href="#CharClasses"><b>B Character Classes</b></a>.</p>
|
|||||||
<p>[<a name="dt-name" title="Name">Definition</a>: A <b>Name</b> is a token beginning
|
<p>[<a name="dt-name" title="Name">Definition</a>: A <b>Name</b> is a token beginning
|
||||||
with a letter or one of a few punctuation characters, and continuing with
|
with a letter or one of a few punctuation characters, and continuing with
|
||||||
letters, digits, hyphens, underscores, colons, or full stops, together known
|
letters, digits, hyphens, underscores, colons, or full stops, together known
|
||||||
as name characters.] Names beginning with the string "<code>xml</code>",
|
as name characters.] Names beginning with the string "<code>xml</code>",
|
||||||
or any string which would match <code>(('X'|'x') ('M'|'m') ('L'|'l'))</code>,
|
or any string which would match <code>(('X'|'x') ('M'|'m') ('L'|'l'))</code>,
|
||||||
are reserved for standardization in this or future versions of this specification.</p>
|
are reserved for standardization in this or future versions of this specification.</p>
|
||||||
<div class="note"><p class="prefix"><b>Note:</b></p>
|
<div class="note"><p class="prefix"><b>Note:</b></p>
|
||||||
@ -321,16 +321,16 @@ of attributes (<a href="#NT-AttValue">AttValue</a>), and external identifiers
|
|||||||
(<a href="#NT-SystemLiteral">SystemLiteral</a>). Note that a <a href="#NT-SystemLiteral">SystemLiteral</a>
|
(<a href="#NT-SystemLiteral">SystemLiteral</a>). Note that a <a href="#NT-SystemLiteral">SystemLiteral</a>
|
||||||
can be parsed without scanning for markup.</p>
|
can be parsed without scanning for markup.</p>
|
||||||
|
|
||||||
<h5>Literals</h5><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td><a name="NT-EntityValue"></a>[9]<5D><><EFBFBD></td><td><code>EntityValue</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'"' ([^%&"] | <a href="#NT-PEReference">PEReference</a>
|
<h5>Literals</h5><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td><a name="NT-EntityValue"></a>[9]<5D><><EFBFBD></td><td><code>EntityValue</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'"' ([^%&"] | <a href="#NT-PEReference">PEReference</a>
|
||||||
| <a href="#NT-Reference">Reference</a>)* '"' </code></td><xsltdebug></xsltdebug></tr><tr valign="baseline"><td></td><td></td><td></td><td><code>|<7C> "'" ([^%&'] | <a href="#NT-PEReference">PEReference</a> | <a href="#NT-Reference">Reference</a>)* "'"</code></td></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-AttValue"></a>[10]<5D><><EFBFBD></td><td><code>AttValue</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'"' ([^<&"] | <a href="#NT-Reference">Reference</a>)*
|
| <a href="#NT-Reference">Reference</a>)* '"' </code></td><xsltdebug></xsltdebug></tr><tr valign="baseline"><td></td><td></td><td></td><td><code>|<7C> "'" ([^%&'] | <a href="#NT-PEReference">PEReference</a> | <a href="#NT-Reference">Reference</a>)* "'"</code></td></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-AttValue"></a>[10]<5D><><EFBFBD></td><td><code>AttValue</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'"' ([^<&"] | <a href="#NT-Reference">Reference</a>)*
|
||||||
'"' </code></td><xsltdebug></xsltdebug></tr><tr valign="baseline"><td></td><td></td><td></td><td><code>|<7C> "'" ([^<&'] | <a href="#NT-Reference">Reference</a>)*
|
'"' </code></td><xsltdebug></xsltdebug></tr><tr valign="baseline"><td></td><td></td><td></td><td><code>|<7C> "'" ([^<&'] | <a href="#NT-Reference">Reference</a>)*
|
||||||
"'"</code></td></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-SystemLiteral"></a>[11]<5D><><EFBFBD></td><td><code>SystemLiteral</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>('"' [^"]* '"') |<7C>("'" [^']* "'") </code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-PubidLiteral"></a>[12]<5D><><EFBFBD></td><td><code>PubidLiteral</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'"' <a href="#NT-PubidChar">PubidChar</a>* '"'
|
"'"</code></td></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-SystemLiteral"></a>[11]<5D><><EFBFBD></td><td><code>SystemLiteral</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>('"' [^"]* '"') |<7C>("'" [^']* "'") </code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-PubidLiteral"></a>[12]<5D><><EFBFBD></td><td><code>PubidLiteral</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'"' <a href="#NT-PubidChar">PubidChar</a>* '"'
|
||||||
| "'" (<a href="#NT-PubidChar">PubidChar</a> - "'")* "'"</code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-PubidChar"></a>[13]<5D><><EFBFBD></td><td><code>PubidChar</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>#x20 | #xD | #xA |<7C>[a-zA-Z0-9] |<7C>[-'()+,./:=?;!*#@$_%]</code></td><xsltdebug></xsltdebug></tr></tbody></table>
|
| "'" (<a href="#NT-PubidChar">PubidChar</a> - "'")* "'"</code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-PubidChar"></a>[13]<5D><><EFBFBD></td><td><code>PubidChar</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>#x20 | #xD | #xA |<7C>[a-zA-Z0-9] |<7C>[-'()+,./:=?;!*#@$_%]</code></td><xsltdebug></xsltdebug></tr></tbody></table>
|
||||||
<div class="note"><p class="prefix"><b>Note:</b></p>
|
<div class="note"><p class="prefix"><b>Note:</b></p>
|
||||||
<p>Although
|
<p>Although
|
||||||
the <a href="#NT-EntityValue">EntityValue</a> production allows the definition
|
the <a href="#NT-EntityValue">EntityValue</a> production allows the definition
|
||||||
of an entity consisting of a single explicit <code><</code> in the literal
|
of an entity consisting of a single explicit <code><</code> in the literal
|
||||||
(e.g., <code><!ENTITY mylt "<"></code>), it is strongly advised to avoid
|
(e.g., <code><!ENTITY mylt "<"></code>), it is strongly advised to avoid
|
||||||
this practice since any reference to that entity will cause a well-formedness
|
this practice since any reference to that entity will cause a well-formedness
|
||||||
error.</p>
|
error.</p>
|
||||||
</div>
|
</div>
|
||||||
@ -351,20 +351,20 @@ within a <a title="Comment" href="#dt-comment">comment</a>, a <a title="Processi
|
|||||||
instruction</a>, or a <a title="CDATA Section" href="#dt-cdsection">CDATA section</a>.
|
instruction</a>, or a <a title="CDATA Section" href="#dt-cdsection">CDATA section</a>.
|
||||||
If they are needed elsewhere, they must be <a title="escape" href="#dt-escape">escaped</a>
|
If they are needed elsewhere, they must be <a title="escape" href="#dt-escape">escaped</a>
|
||||||
using either <a title="Character Reference" href="#dt-charref">numeric character references</a>
|
using either <a title="Character Reference" href="#dt-charref">numeric character references</a>
|
||||||
or the strings "<code>&amp;</code>" and "<code>&lt;</code>"
|
or the strings "<code>&amp;</code>" and "<code>&lt;</code>"
|
||||||
respectively. The right angle bracket (>) may be represented using the string "<code>&gt;</code>",
|
respectively. The right angle bracket (>) may be represented using the string "<code>&gt;</code>",
|
||||||
and must, <a title="For Compatibility" href="#dt-compat">for compatibility</a>, be escaped
|
and must, <a title="For Compatibility" href="#dt-compat">for compatibility</a>, be escaped
|
||||||
using "<code>&gt;</code>" or a character reference when it
|
using "<code>&gt;</code>" or a character reference when it
|
||||||
appears in the string "<code>]]></code>" in content, when
|
appears in the string "<code>]]></code>" in content, when
|
||||||
that string is not marking the end of a <a title="CDATA Section" href="#dt-cdsection">CDATA
|
that string is not marking the end of a <a title="CDATA Section" href="#dt-cdsection">CDATA
|
||||||
section</a>.</p>
|
section</a>.</p>
|
||||||
<p>In the content of elements, character data is any string of characters
|
<p>In the content of elements, character data is any string of characters
|
||||||
which does not contain the start-delimiter of any markup. In a CDATA section,
|
which does not contain the start-delimiter of any markup. In a CDATA section,
|
||||||
character data is any string of characters not including the CDATA-section-close
|
character data is any string of characters not including the CDATA-section-close
|
||||||
delimiter, "<code>]]></code>".</p>
|
delimiter, "<code>]]></code>".</p>
|
||||||
<p>To allow attribute values to contain both single and double quotes, the
|
<p>To allow attribute values to contain both single and double quotes, the
|
||||||
apostrophe or single-quote character (') may be represented as "<code>&apos;</code>",
|
apostrophe or single-quote character (') may be represented as "<code>&apos;</code>",
|
||||||
and the double-quote character (") as "<code>&quot;</code>".</p>
|
and the double-quote character (") as "<code>&quot;</code>".</p>
|
||||||
|
|
||||||
<h5>Character Data</h5><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td><a name="NT-CharData"></a>[14]<5D><><EFBFBD></td><td><code>CharData</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>[^<&]* - ([^<&]* ']]>' [^<&]*)</code></td><xsltdebug></xsltdebug></tr></tbody></table>
|
<h5>Character Data</h5><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td><a name="NT-CharData"></a>[14]<5D><><EFBFBD></td><td><code>CharData</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>[^<&]* - ([^<&]* ']]>' [^<&]*)</code></td><xsltdebug></xsltdebug></tr></tbody></table>
|
||||||
</div>
|
</div>
|
||||||
@ -377,7 +377,7 @@ in addition, they may appear within the document type declaration at places
|
|||||||
allowed by the grammar. They are not part of the document's <a title="Character Data" href="#dt-chardata">character
|
allowed by the grammar. They are not part of the document's <a title="Character Data" href="#dt-chardata">character
|
||||||
data</a>; an XML processor may, but need not, make it possible for an
|
data</a>; an XML processor may, but need not, make it possible for an
|
||||||
application to retrieve the text of comments. <a title="For Compatibility" href="#dt-compat">For
|
application to retrieve the text of comments. <a title="For Compatibility" href="#dt-compat">For
|
||||||
compatibility</a>, the string "<code>--</code>" (double-hyphen)
|
compatibility</a>, the string "<code>--</code>" (double-hyphen)
|
||||||
must not occur within comments.] Parameter
|
must not occur within comments.] Parameter
|
||||||
entity references are not recognized within comments.</p>
|
entity references are not recognized within comments.</p>
|
||||||
|
|
||||||
@ -402,7 +402,7 @@ following example is <em>not</em> well-formed.</p>
|
|||||||
<p>PIs are not part of the document's <a title="Character Data" href="#dt-chardata">character
|
<p>PIs are not part of the document's <a title="Character Data" href="#dt-chardata">character
|
||||||
data</a>, but must be passed through to the application. The PI begins
|
data</a>, but must be passed through to the application. The PI begins
|
||||||
with a target (<a href="#NT-PITarget">PITarget</a>) used to identify the application
|
with a target (<a href="#NT-PITarget">PITarget</a>) used to identify the application
|
||||||
to which the instruction is directed. The target names "<code>XML</code>", "<code>xml</code>",
|
to which the instruction is directed. The target names "<code>XML</code>", "<code>xml</code>",
|
||||||
and so on are reserved for standardization in this or future versions of this
|
and so on are reserved for standardization in this or future versions of this
|
||||||
specification. The XML <a title="Notation" href="#dt-notation">Notation</a> mechanism
|
specification. The XML <a title="Notation" href="#dt-notation">Notation</a> mechanism
|
||||||
may be used for formal declaration of PI targets. Parameter
|
may be used for formal declaration of PI targets. Parameter
|
||||||
@ -414,17 +414,17 @@ entity references are not recognized within processing instructions.</p>
|
|||||||
<p>[<a name="dt-cdsection" title="CDATA Section">Definition</a>: <b>CDATA sections</b>
|
<p>[<a name="dt-cdsection" title="CDATA Section">Definition</a>: <b>CDATA sections</b>
|
||||||
may occur anywhere character data may occur; they are used to escape blocks
|
may occur anywhere character data may occur; they are used to escape blocks
|
||||||
of text containing characters which would otherwise be recognized as markup.
|
of text containing characters which would otherwise be recognized as markup.
|
||||||
CDATA sections begin with the string "<code><![CDATA[</code>"
|
CDATA sections begin with the string "<code><![CDATA[</code>"
|
||||||
and end with the string "<code>]]></code>":]</p>
|
and end with the string "<code>]]></code>":]</p>
|
||||||
|
|
||||||
<h5>CDATA Sections</h5><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td><a name="NT-CDSect"></a>[18]<5D><><EFBFBD></td><td><code>CDSect</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code><a href="#NT-CDStart">CDStart</a> <a href="#NT-CData">CData</a> <a href="#NT-CDEnd">CDEnd</a></code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-CDStart"></a>[19]<5D><><EFBFBD></td><td><code>CDStart</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'<![CDATA['</code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-CData"></a>[20]<5D><><EFBFBD></td><td><code>CData</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>(<a href="#NT-Char">Char</a>* - (<a href="#NT-Char">Char</a>*
|
<h5>CDATA Sections</h5><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td><a name="NT-CDSect"></a>[18]<5D><><EFBFBD></td><td><code>CDSect</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code><a href="#NT-CDStart">CDStart</a> <a href="#NT-CData">CData</a> <a href="#NT-CDEnd">CDEnd</a></code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-CDStart"></a>[19]<5D><><EFBFBD></td><td><code>CDStart</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'<![CDATA['</code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-CData"></a>[20]<5D><><EFBFBD></td><td><code>CData</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>(<a href="#NT-Char">Char</a>* - (<a href="#NT-Char">Char</a>*
|
||||||
']]>' <a href="#NT-Char">Char</a>*)) </code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-CDEnd"></a>[21]<5D><><EFBFBD></td><td><code>CDEnd</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>']]>'</code></td><xsltdebug></xsltdebug></tr></tbody></table>
|
']]>' <a href="#NT-Char">Char</a>*)) </code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-CDEnd"></a>[21]<5D><><EFBFBD></td><td><code>CDEnd</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>']]>'</code></td><xsltdebug></xsltdebug></tr></tbody></table>
|
||||||
<p>Within a CDATA section, only the <a href="#NT-CDEnd">CDEnd</a> string is
|
<p>Within a CDATA section, only the <a href="#NT-CDEnd">CDEnd</a> string is
|
||||||
recognized as markup, so that left angle brackets and ampersands may occur
|
recognized as markup, so that left angle brackets and ampersands may occur
|
||||||
in their literal form; they need not (and cannot) be escaped using "<code>&lt;</code>"
|
in their literal form; they need not (and cannot) be escaped using "<code>&lt;</code>"
|
||||||
and "<code>&amp;</code>". CDATA sections cannot nest.</p>
|
and "<code>&amp;</code>". CDATA sections cannot nest.</p>
|
||||||
<p>An example of a CDATA section, in which "<code><greeting></code>"
|
<p>An example of a CDATA section, in which "<code><greeting></code>"
|
||||||
and "<code></greeting></code>" are recognized as <a title="Character Data" href="#dt-chardata">character data</a>, not <a title="Markup" href="#dt-markup">markup</a>:</p>
|
and "<code></greeting></code>" are recognized as <a title="Character Data" href="#dt-chardata">character data</a>, not <a title="Markup" href="#dt-markup">markup</a>:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><![CDATA[<greeting>Hello, world!</greeting>]]> </pre></td></tr></table>
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><![CDATA[<greeting>Hello, world!</greeting>]]> </pre></td></tr></table>
|
||||||
</div>
|
</div>
|
||||||
<div class="div2">
|
<div class="div2">
|
||||||
@ -433,14 +433,14 @@ and "<code></greeting></code>" are recognized as <a title="Chara
|
|||||||
<p>[<a name="dt-xmldecl" title="XML Declaration">Definition</a>: XML documents should
|
<p>[<a name="dt-xmldecl" title="XML Declaration">Definition</a>: XML documents should
|
||||||
begin with an <b>XML declaration</b> which specifies the version of
|
begin with an <b>XML declaration</b> which specifies the version of
|
||||||
XML being used.] For example, the following is a complete XML document, <a title="Well-Formed" href="#dt-wellformed">well-formed</a> but not <a title="Validity" href="#dt-valid">valid</a>:</p>
|
XML being used.] For example, the following is a complete XML document, <a title="Well-Formed" href="#dt-wellformed">well-formed</a> but not <a title="Validity" href="#dt-valid">valid</a>:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><?xml version="1.0"?> <greeting>Hello, world!</greeting> </pre></td></tr></table>
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><?xml version="1.0"?> <greeting>Hello, world!</greeting> </pre></td></tr></table>
|
||||||
<p>and so is this:</p>
|
<p>and so is this:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><greeting>Hello, world!</greeting></pre></td></tr></table>
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><greeting>Hello, world!</greeting></pre></td></tr></table>
|
||||||
<p>The version number "<code>1.0</code>" should be used to indicate
|
<p>The version number "<code>1.0</code>" should be used to indicate
|
||||||
conformance to this version of this specification; it is an error for a document
|
conformance to this version of this specification; it is an error for a document
|
||||||
to use the value "<code>1.0</code>" if it does not conform to
|
to use the value "<code>1.0</code>" if it does not conform to
|
||||||
this version of this specification. It is the intent of the XML working group
|
this version of this specification. It is the intent of the XML working group
|
||||||
to give later versions of this specification numbers other than "<code>1.0</code>",
|
to give later versions of this specification numbers other than "<code>1.0</code>",
|
||||||
but this intent does not indicate a commitment to produce any future versions
|
but this intent does not indicate a commitment to produce any future versions
|
||||||
of XML, nor if any are produced, to use any particular numbering scheme. Since
|
of XML, nor if any are produced, to use any particular numbering scheme. Since
|
||||||
future versions are not ruled out, this construct is provided as a means to
|
future versions are not ruled out, this construct is provided as a means to
|
||||||
@ -462,8 +462,8 @@ in the document.</p>
|
|||||||
(<a href="#NT-doctypedecl">doctypedecl</a> <a href="#NT-Misc">Misc</a>*)?</code></td><xsltdebug></xsltdebug></tr>
|
(<a href="#NT-doctypedecl">doctypedecl</a> <a href="#NT-Misc">Misc</a>*)?</code></td><xsltdebug></xsltdebug></tr>
|
||||||
<tr valign="baseline"><td><a name="NT-XMLDecl"></a>[23]<5D><><EFBFBD></td><td><code>XMLDecl</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'<?xml' <a href="#NT-VersionInfo">VersionInfo</a> <a href="#NT-EncodingDecl">EncodingDecl</a>? <a href="#NT-SDDecl">SDDecl</a>? <a href="#NT-S">S</a>? '?>'</code></td><xsltdebug></xsltdebug></tr>
|
<tr valign="baseline"><td><a name="NT-XMLDecl"></a>[23]<5D><><EFBFBD></td><td><code>XMLDecl</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'<?xml' <a href="#NT-VersionInfo">VersionInfo</a> <a href="#NT-EncodingDecl">EncodingDecl</a>? <a href="#NT-SDDecl">SDDecl</a>? <a href="#NT-S">S</a>? '?>'</code></td><xsltdebug></xsltdebug></tr>
|
||||||
<tr valign="baseline"><td><a name="NT-VersionInfo"></a>[24]<5D><><EFBFBD></td><td><code>VersionInfo</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code><a href="#NT-S">S</a> 'version' <a href="#NT-Eq">Eq</a>
|
<tr valign="baseline"><td><a name="NT-VersionInfo"></a>[24]<5D><><EFBFBD></td><td><code>VersionInfo</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code><a href="#NT-S">S</a> 'version' <a href="#NT-Eq">Eq</a>
|
||||||
("'" <a href="#NT-VersionNum">VersionNum</a> "'" | '"' <a href="#NT-VersionNum">VersionNum</a>
|
("'" <a href="#NT-VersionNum">VersionNum</a> "'" | '"' <a href="#NT-VersionNum">VersionNum</a>
|
||||||
'"')<i>/* */</i></code></td><xsltdebug></xsltdebug></tr>
|
'"')<i>/* */</i></code></td><xsltdebug></xsltdebug></tr>
|
||||||
<tr valign="baseline"><td><a name="NT-Eq"></a>[25]<5D><><EFBFBD></td><td><code>Eq</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code><a href="#NT-S">S</a>? '=' <a href="#NT-S">S</a>?</code></td><xsltdebug></xsltdebug></tr>
|
<tr valign="baseline"><td><a name="NT-Eq"></a>[25]<5D><><EFBFBD></td><td><code>Eq</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code><a href="#NT-S">S</a>? '=' <a href="#NT-S">S</a>?</code></td><xsltdebug></xsltdebug></tr>
|
||||||
<tr valign="baseline"><td><a name="NT-VersionNum"></a>[26]<5D><><EFBFBD></td><td><code>VersionNum</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>([a-zA-Z0-9_.:] | '-')+</code></td><xsltdebug></xsltdebug></tr>
|
<tr valign="baseline"><td><a name="NT-VersionNum"></a>[26]<5D><><EFBFBD></td><td><code>VersionNum</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>([a-zA-Z0-9_.:] | '-')+</code></td><xsltdebug></xsltdebug></tr>
|
||||||
<tr valign="baseline"><td><a name="NT-Misc"></a>[27]<5D><><EFBFBD></td><td><code>Misc</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code><a href="#NT-Comment">Comment</a> | <a href="#NT-PI">PI</a>
|
<tr valign="baseline"><td><a name="NT-Misc"></a>[27]<5D><><EFBFBD></td><td><code>Misc</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code><a href="#NT-Comment">Comment</a> | <a href="#NT-PI">PI</a>
|
||||||
@ -549,12 +549,12 @@ internal subset in that in them, <a title="Parameter-entity reference" href="#dt
|
|||||||
references</a> are permitted <em>within</em> markup declarations,
|
references</a> are permitted <em>within</em> markup declarations,
|
||||||
not only <em>between</em> markup declarations.</p>
|
not only <em>between</em> markup declarations.</p>
|
||||||
<p>An example of an XML document with a document type declaration:</p>
|
<p>An example of an XML document with a document type declaration:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><?xml version="1.0"?> <!DOCTYPE greeting SYSTEM "hello.dtd"> <greeting>Hello, world!</greeting> </pre></td></tr></table>
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><?xml version="1.0"?> <!DOCTYPE greeting SYSTEM "hello.dtd"> <greeting>Hello, world!</greeting> </pre></td></tr></table>
|
||||||
<p>The <a title="System Identifier" href="#dt-sysid">system identifier</a> "<code>hello.dtd</code>"
|
<p>The <a title="System Identifier" href="#dt-sysid">system identifier</a> "<code>hello.dtd</code>"
|
||||||
gives the address
|
gives the address
|
||||||
(a URI reference) of a DTD for the document.</p>
|
(a URI reference) of a DTD for the document.</p>
|
||||||
<p>The declarations can also be given locally, as in this example:</p>
|
<p>The declarations can also be given locally, as in this example:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><?xml version="1.0" encoding="UTF-8" ?>
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><?xml version="1.0" encoding="UTF-8" ?>
|
||||||
<!DOCTYPE greeting [
|
<!DOCTYPE greeting [
|
||||||
<!ELEMENT greeting (#PCDATA)>
|
<!ELEMENT greeting (#PCDATA)>
|
||||||
]>
|
]>
|
||||||
@ -581,24 +581,24 @@ them).]</p>
|
|||||||
|
|
||||||
<h5>Standalone Document Declaration</h5><table class="scrap" summary="Scrap"><tbody>
|
<h5>Standalone Document Declaration</h5><table class="scrap" summary="Scrap"><tbody>
|
||||||
<tr valign="baseline"><td><a name="NT-SDDecl"></a>[32]<5D><><EFBFBD></td><td><code>SDDecl</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code> <a href="#NT-S">S</a> 'standalone' <a href="#NT-Eq">Eq</a>
|
<tr valign="baseline"><td><a name="NT-SDDecl"></a>[32]<5D><><EFBFBD></td><td><code>SDDecl</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code> <a href="#NT-S">S</a> 'standalone' <a href="#NT-Eq">Eq</a>
|
||||||
(("'" ('yes' | 'no') "'") | ('"' ('yes' | 'no') '"')) </code></td><xsltdebug></xsltdebug><td><a href="#vc-check-rmd">[VC: Standalone Document Declaration]</a></td></tr>
|
(("'" ('yes' | 'no') "'") | ('"' ('yes' | 'no') '"')) </code></td><xsltdebug></xsltdebug><td><a href="#vc-check-rmd">[VC: Standalone Document Declaration]</a></td></tr>
|
||||||
</tbody></table>
|
</tbody></table>
|
||||||
<p>In a standalone document declaration, the value "yes" indicates
|
<p>In a standalone document declaration, the value "yes" indicates
|
||||||
that there are no <a title="External Markup Declaration" href="#dt-extmkpdecl">external markup declarations</a> which
|
that there are no <a title="External Markup Declaration" href="#dt-extmkpdecl">external markup declarations</a> which
|
||||||
affect the information passed from the XML processor to the application. The
|
affect the information passed from the XML processor to the application. The
|
||||||
value "no" indicates that there are or may be such external
|
value "no" indicates that there are or may be such external
|
||||||
markup declarations. Note that the standalone document declaration only denotes
|
markup declarations. Note that the standalone document declaration only denotes
|
||||||
the presence of external <em>declarations</em>; the presence, in a document,
|
the presence of external <em>declarations</em>; the presence, in a document,
|
||||||
of references to external <em>entities</em>, when those entities are internally
|
of references to external <em>entities</em>, when those entities are internally
|
||||||
declared, does not change its standalone status.</p>
|
declared, does not change its standalone status.</p>
|
||||||
<p>If there are no external markup declarations, the standalone document declaration
|
<p>If there are no external markup declarations, the standalone document declaration
|
||||||
has no meaning. If there are external markup declarations but there is no
|
has no meaning. If there are external markup declarations but there is no
|
||||||
standalone document declaration, the value "no" is assumed.</p>
|
standalone document declaration, the value "no" is assumed.</p>
|
||||||
<p>Any XML document for which <code>standalone="no"</code> holds can be converted
|
<p>Any XML document for which <code>standalone="no"</code> holds can be converted
|
||||||
algorithmically to a standalone document, which may be desirable for some
|
algorithmically to a standalone document, which may be desirable for some
|
||||||
network delivery applications.</p>
|
network delivery applications.</p>
|
||||||
<div class="constraint"><p class="prefix"><a name="vc-check-rmd"></a><b>Validity constraint: Standalone Document Declaration</b></p><p>The
|
<div class="constraint"><p class="prefix"><a name="vc-check-rmd"></a><b>Validity constraint: Standalone Document Declaration</b></p><p>The
|
||||||
standalone document declaration must have the value "no" if
|
standalone document declaration must have the value "no" if
|
||||||
any external markup declarations contain declarations of:</p>
|
any external markup declarations contain declarations of:</p>
|
||||||
<ul>
|
<ul>
|
||||||
<li><p>attributes with <a title="Attribute Default" href="#dt-default">default</a> values,
|
<li><p>attributes with <a title="Attribute Default" href="#dt-default">default</a> values,
|
||||||
@ -618,16 +618,16 @@ if white space occurs directly within any instance of those types.</p></li>
|
|||||||
</ul>
|
</ul>
|
||||||
</div>
|
</div>
|
||||||
<p>An example XML declaration with a standalone document declaration:</p>
|
<p>An example XML declaration with a standalone document declaration:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><?xml version="1.0" standalone='yes'?></pre></td></tr></table>
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><?xml version="1.0" standalone='yes'?></pre></td></tr></table>
|
||||||
</div>
|
</div>
|
||||||
<div class="div2">
|
<div class="div2">
|
||||||
|
|
||||||
<h3><a name="sec-white-space"></a>2.10 White Space Handling</h3>
|
<h3><a name="sec-white-space"></a>2.10 White Space Handling</h3>
|
||||||
<p>In editing XML documents, it is often convenient to use "white space"
|
<p>In editing XML documents, it is often convenient to use "white space"
|
||||||
(spaces, tabs, and blank lines)
|
(spaces, tabs, and blank lines)
|
||||||
to set apart the markup for greater readability. Such white space is typically
|
to set apart the markup for greater readability. Such white space is typically
|
||||||
not intended for inclusion in the delivered version of the document. On the
|
not intended for inclusion in the delivered version of the document. On the
|
||||||
other hand, "significant" white space that should be preserved
|
other hand, "significant" white space that should be preserved
|
||||||
in the delivered version is common, for example in poetry and source code.</p>
|
in the delivered version is common, for example in poetry and source code.</p>
|
||||||
<p>An <a title="XML Processor" href="#dt-xml-proc">XML processor</a> must always pass
|
<p>An <a title="XML Processor" href="#dt-xml-proc">XML processor</a> must always pass
|
||||||
all characters in a document that are not markup through to the application.
|
all characters in a document that are not markup through to the application.
|
||||||
@ -640,14 +640,14 @@ white space should be preserved by applications. In valid documents, this
|
|||||||
attribute, like any other, must be <a title="Attribute-List Declaration" href="#dt-attdecl">declared</a>
|
attribute, like any other, must be <a title="Attribute-List Declaration" href="#dt-attdecl">declared</a>
|
||||||
if it is used. When declared, it must be given as an <a title="Enumerated Attribute Values" href="#dt-enumerated">enumerated
|
if it is used. When declared, it must be given as an <a title="Enumerated Attribute Values" href="#dt-enumerated">enumerated
|
||||||
type</a> whose values
|
type</a> whose values
|
||||||
are one or both of "default" and "preserve".
|
are one or both of "default" and "preserve".
|
||||||
For example:</p>
|
For example:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ATTLIST poem xml:space (default|preserve) 'preserve'>
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ATTLIST poem xml:space (default|preserve) 'preserve'>
|
||||||
|
|
||||||
<!-- -->
|
<!-- -->
|
||||||
<!ATTLIST pre xml:space (preserve) #FIXED 'preserve'></pre></td></tr></table>
|
<!ATTLIST pre xml:space (preserve) #FIXED 'preserve'></pre></td></tr></table>
|
||||||
<p>The value "default" signals that applications' default white-space
|
<p>The value "default" signals that applications' default white-space
|
||||||
processing modes are acceptable for this element; the value "preserve"
|
processing modes are acceptable for this element; the value "preserve"
|
||||||
indicates the intent that applications preserve all the white space. This
|
indicates the intent that applications preserve all the white space. This
|
||||||
declared intent is considered to apply to all elements within the content
|
declared intent is considered to apply to all elements within the content
|
||||||
of the element where it is specified, unless overriden with another instance
|
of the element where it is specified, unless overriden with another instance
|
||||||
@ -700,10 +700,10 @@ languages not presently covered by <a href="#ISO639">[ISO 639]</a>.</p>
|
|||||||
|
|
||||||
|
|
||||||
<p>For example:</p>
|
<p>For example:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><p xml:lang="en">The quick brown fox jumps over the lazy dog.</p>
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><p xml:lang="en">The quick brown fox jumps over the lazy dog.</p>
|
||||||
<p xml:lang="en-GB">What colour is it?</p>
|
<p xml:lang="en-GB">What colour is it?</p>
|
||||||
<p xml:lang="en-US">What color is it?</p>
|
<p xml:lang="en-US">What color is it?</p>
|
||||||
<sp who="Faust" desc='leise' xml:lang="de">
|
<sp who="Faust" desc='leise' xml:lang="de">
|
||||||
<l>Habe nun, ach! Philosophie,</l>
|
<l>Habe nun, ach! Philosophie,</l>
|
||||||
<l>Juristerei, und Medizin</l>
|
<l>Juristerei, und Medizin</l>
|
||||||
<l>und leider auch Theologie</l>
|
<l>und leider auch Theologie</l>
|
||||||
@ -733,8 +733,8 @@ document</a> contains one or more <b>elements</b>, the boundaries
|
|||||||
of which are either delimited by <a title="Start-Tag" href="#dt-stag">start-tags</a>
|
of which are either delimited by <a title="Start-Tag" href="#dt-stag">start-tags</a>
|
||||||
and <a title="End Tag" href="#dt-etag">end-tags</a>, or, for <a title="Empty" href="#dt-empty">empty</a>
|
and <a title="End Tag" href="#dt-etag">end-tags</a>, or, for <a title="Empty" href="#dt-empty">empty</a>
|
||||||
elements, by an <a title="empty-element tag" href="#dt-eetag">empty-element tag</a>. Each
|
elements, by an <a title="empty-element tag" href="#dt-eetag">empty-element tag</a>. Each
|
||||||
element has a type, identified by name, sometimes called its "generic
|
element has a type, identified by name, sometimes called its "generic
|
||||||
identifier" (GI), and may have a set of attribute specifications.]
|
identifier" (GI), and may have a set of attribute specifications.]
|
||||||
Each attribute specification has a <a title="Attribute Name" href="#dt-attrname">name</a>
|
Each attribute specification has a <a title="Attribute Name" href="#dt-attrname">name</a>
|
||||||
and a <a title="Attribute Value" href="#dt-attrval">value</a>.</p>
|
and a <a title="Attribute Value" href="#dt-attrval">value</a>.</p>
|
||||||
|
|
||||||
@ -780,7 +780,7 @@ XML element is marked by a <b>start-tag</b>.]</p>
|
|||||||
<p>The <a href="#NT-Name">Name</a> in the start- and end-tags gives the element's <b>type</b>. [<a name="dt-attr" title="Attribute">Definition</a>: The <a href="#NT-Name">Name</a>-<a href="#NT-AttValue">AttValue</a>
|
<p>The <a href="#NT-Name">Name</a> in the start- and end-tags gives the element's <b>type</b>. [<a name="dt-attr" title="Attribute">Definition</a>: The <a href="#NT-Name">Name</a>-<a href="#NT-AttValue">AttValue</a>
|
||||||
pairs are referred to as the <b>attribute specifications</b> of the
|
pairs are referred to as the <b>attribute specifications</b> of the
|
||||||
element], [<a name="dt-attrname" title="Attribute Name">Definition</a>: with the <a href="#NT-Name">Name</a> in each pair referred to as the <b>attribute name</b>]
|
element], [<a name="dt-attrname" title="Attribute Name">Definition</a>: with the <a href="#NT-Name">Name</a> in each pair referred to as the <b>attribute name</b>]
|
||||||
and [<a name="dt-attrval" title="Attribute Value">Definition</a>: the content of the <a href="#NT-AttValue">AttValue</a> (the text between the <code>'</code> or <code>"</code>
|
and [<a name="dt-attrval" title="Attribute Value">Definition</a>: the content of the <a href="#NT-AttValue">AttValue</a> (the text between the <code>'</code> or <code>"</code>
|
||||||
delimiters) as the <b>attribute value</b>.]Note
|
delimiters) as the <b>attribute value</b>.]Note
|
||||||
that the order of attribute specifications in a start-tag or empty-element
|
that the order of attribute specifications in a start-tag or empty-element
|
||||||
tag is not significant.</p>
|
tag is not significant.</p>
|
||||||
@ -799,7 +799,7 @@ values cannot contain direct or indirect entity references to external entities.
|
|||||||
referred to directly or indirectly in an attribute value must not contain a <code><</code>.</p>
|
referred to directly or indirectly in an attribute value must not contain a <code><</code>.</p>
|
||||||
</div>
|
</div>
|
||||||
<p>An example of a start-tag:</p>
|
<p>An example of a start-tag:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><termdef id="dt-dog" term="dog"></pre></td></tr></table>
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><termdef id="dt-dog" term="dog"></pre></td></tr></table>
|
||||||
<p>[<a name="dt-etag" title="End Tag">Definition</a>: The end of every element that begins
|
<p>[<a name="dt-etag" title="End Tag">Definition</a>: The end of every element that begins
|
||||||
with a start-tag must be marked by an <b>end-tag</b> containing a name
|
with a start-tag must be marked by an <b>end-tag</b> containing a name
|
||||||
that echoes the element's type as given in the start-tag:]</p>
|
that echoes the element's type as given in the start-tag:]</p>
|
||||||
@ -833,8 +833,8 @@ interoperability</a>, the empty-element tag should
|
|||||||
be used, and should only be used, for elements which are declared
|
be used, and should only be used, for elements which are declared
|
||||||
EMPTY.</p>
|
EMPTY.</p>
|
||||||
<p>Examples of empty elements:</p>
|
<p>Examples of empty elements:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><IMG align="left"
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><IMG align="left"
|
||||||
src="http://www.w3.org/Icons/WWW/w3c_home" />
|
src="http://www.w3.org/Icons/WWW/w3c_home" />
|
||||||
<br></br>
|
<br></br>
|
||||||
<br/></pre></td></tr></table>
|
<br/></pre></td></tr></table>
|
||||||
</div>
|
</div>
|
||||||
@ -938,8 +938,8 @@ but not their order or their number of occurrences:</p>
|
|||||||
</tbody></table>
|
</tbody></table>
|
||||||
<p>where the <a href="#NT-Name">Name</a>s give the types of elements that
|
<p>where the <a href="#NT-Name">Name</a>s give the types of elements that
|
||||||
may appear as children. The
|
may appear as children. The
|
||||||
keyword <b>#PCDATA</b> derives historically from the term "parsed
|
keyword <b>#PCDATA</b> derives historically from the term "parsed
|
||||||
character data."</p>
|
character data."</p>
|
||||||
<div class="constraint"><p class="prefix"><a name="vc-MixedChildrenUnique"></a><b>Validity constraint: No Duplicate Types</b></p><p>The
|
<div class="constraint"><p class="prefix"><a name="vc-MixedChildrenUnique"></a><b>Validity constraint: No Duplicate Types</b></p><p>The
|
||||||
same name must not appear more than once in a single mixed-content declaration.</p>
|
same name must not appear more than once in a single mixed-content declaration.</p>
|
||||||
</div>
|
</div>
|
||||||
@ -1093,9 +1093,9 @@ that attribute must match the default value.</p>
|
|||||||
id ID #REQUIRED
|
id ID #REQUIRED
|
||||||
name CDATA #IMPLIED>
|
name CDATA #IMPLIED>
|
||||||
<!ATTLIST list
|
<!ATTLIST list
|
||||||
type (bullets|ordered|glossary) "ordered">
|
type (bullets|ordered|glossary) "ordered">
|
||||||
<!ATTLIST form
|
<!ATTLIST form
|
||||||
method CDATA #FIXED "POST"></pre></td></tr></table>
|
method CDATA #FIXED "POST"></pre></td></tr></table>
|
||||||
</div>
|
</div>
|
||||||
<div class="div3">
|
<div class="div3">
|
||||||
|
|
||||||
@ -1144,21 +1144,21 @@ by a non-validating processor
|
|||||||
as if declared <b>CDATA</b>.</p>
|
as if declared <b>CDATA</b>.</p>
|
||||||
<p>Following are examples of attribute normalization. Given the following
|
<p>Following are examples of attribute normalization. Given the following
|
||||||
declarations:</p>
|
declarations:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY d "&#xD;">
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY d "&#xD;">
|
||||||
<!ENTITY a "&#xA;">
|
<!ENTITY a "&#xA;">
|
||||||
<!ENTITY da "&#xD;&#xA;"></pre></td></tr></table>
|
<!ENTITY da "&#xD;&#xA;"></pre></td></tr></table>
|
||||||
<p>the attribute specifications in the left column below would be normalized
|
<p>the attribute specifications in the left column below would be normalized
|
||||||
to the character sequences of the middle column if the attribute <code>a</code>
|
to the character sequences of the middle column if the attribute <code>a</code>
|
||||||
is declared <b>NMTOKENS</b> and to those of the right columns if <code>a</code>
|
is declared <b>NMTOKENS</b> and to those of the right columns if <code>a</code>
|
||||||
is declared <b>CDATA</b>.</p>
|
is declared <b>CDATA</b>.</p>
|
||||||
<table border="1" frame="border"><thead><tr><th colspan="1" rowspan="1">Attribute specification</th>
|
<table border="1" frame="border"><thead><tr><th colspan="1" rowspan="1">Attribute specification</th>
|
||||||
<th colspan="1" rowspan="1">a is NMTOKENS</th><th colspan="1" rowspan="1">a is CDATA</th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre>a="
|
<th colspan="1" rowspan="1">a is NMTOKENS</th><th colspan="1" rowspan="1">a is CDATA</th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre>a="
|
||||||
|
|
||||||
xyz"</pre></td></tr></table></td><td colspan="1" rowspan="1"><code>x y z</code></td><td colspan="1" rowspan="1"><code>#x20 #x20 x y z</code></td>
|
xyz"</pre></td></tr></table></td><td colspan="1" rowspan="1"><code>x y z</code></td><td colspan="1" rowspan="1"><code>#x20 #x20 x y z</code></td>
|
||||||
</tr><tr><td colspan="1" rowspan="1"><table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre>a="&d;&d;A&a;&a;B&da;"</pre></td></tr></table></td><td colspan="1" rowspan="1"><code>A
|
</tr><tr><td colspan="1" rowspan="1"><table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre>a="&d;&d;A&a;&a;B&da;"</pre></td></tr></table></td><td colspan="1" rowspan="1"><code>A
|
||||||
#x20 B</code></td><td colspan="1" rowspan="1"><code>#x20 #x20 A #x20 #x20 B #x20 #x20</code></td>
|
#x20 B</code></td><td colspan="1" rowspan="1"><code>#x20 #x20 A #x20 #x20 B #x20 #x20</code></td>
|
||||||
</tr><tr><td colspan="1" rowspan="1"><table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre>a=
|
</tr><tr><td colspan="1" rowspan="1"><table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre>a=
|
||||||
"&#xd;&#xd;A&#xa;&#xa;B&#xd;&#xa;"</pre></td></tr></table></td><td colspan="1" rowspan="1"><code>#xD
|
"&#xd;&#xd;A&#xa;&#xa;B&#xd;&#xa;"</pre></td></tr></table></td><td colspan="1" rowspan="1"><code>#xD
|
||||||
#xD A #xA #xA B #xD #xA</code></td><td colspan="1" rowspan="1"><code>#xD #xD A #xA #xA B #xD #xD</code></td>
|
#xD A #xA #xA B #xD #xA</code></td><td colspan="1" rowspan="1"><code>#xD #xD A #xA #xA B #xD #xD</code></td>
|
||||||
</tr></tbody></table>
|
</tr></tbody></table>
|
||||||
<p>Note that the last example is invalid (but well-formed) if <code>a</code>
|
<p>Note that the last example is invalid (but well-formed) if <code>a</code>
|
||||||
@ -1186,8 +1186,8 @@ Conditional Section/PE Nesting]</a></td></tr>
|
|||||||
('<![' | ']]>') <a href="#NT-Char">Char</a>*) </code></td><xsltdebug></xsltdebug></tr>
|
('<![' | ']]>') <a href="#NT-Char">Char</a>*) </code></td><xsltdebug></xsltdebug></tr>
|
||||||
</tbody></table>
|
</tbody></table>
|
||||||
<div class="constraint"><p class="prefix"><a name="condsec-nesting"></a><b>Validity constraint: Proper
|
<div class="constraint"><p class="prefix"><a name="condsec-nesting"></a><b>Validity constraint: Proper
|
||||||
Conditional Section/PE Nesting</b></p><p>If any of the "<code><![</code>",
|
Conditional Section/PE Nesting</b></p><p>If any of the "<code><![</code>",
|
||||||
"<code>[</code>", or "<code>]]></code>" of a conditional section is contained
|
"<code>[</code>", or "<code>]]></code>" of a conditional section is contained
|
||||||
in the replacement text for a parameter-entity reference, all of them must
|
in the replacement text for a parameter-entity reference, all of them must
|
||||||
be contained in the same replacement text.</p>
|
be contained in the same replacement text.</p>
|
||||||
</div>
|
</div>
|
||||||
@ -1202,8 +1202,8 @@ If a conditional section with a keyword of <b>INCLUDE</b> occurs within
|
|||||||
a larger conditional section with a keyword of <b>IGNORE</b>, both the outer
|
a larger conditional section with a keyword of <b>IGNORE</b>, both the outer
|
||||||
and the inner conditional sections are ignored. The contents
|
and the inner conditional sections are ignored. The contents
|
||||||
of an ignored conditional section are parsed by ignoring all characters after
|
of an ignored conditional section are parsed by ignoring all characters after
|
||||||
the "<code>[</code>" following the keyword, except conditional section starts
|
the "<code>[</code>" following the keyword, except conditional section starts
|
||||||
"<code><![</code>" and ends "<code>]]></code>", until the matching conditional
|
"<code><![</code>" and ends "<code>]]></code>", until the matching conditional
|
||||||
section end is found. Parameter entity references are not recognized in this
|
section end is found. Parameter entity references are not recognized in this
|
||||||
process.</p>
|
process.</p>
|
||||||
<p>If the keyword of the conditional section is a parameter-entity reference,
|
<p>If the keyword of the conditional section is a parameter-entity reference,
|
||||||
@ -1267,10 +1267,10 @@ set, for example one not directly accessible from available input devices.]</p>
|
|||||||
<div class="constraint"><p class="prefix"><a name="wf-Legalchar"></a><b>Well-formedness constraint: Legal Character</b></p><p>Characters referred
|
<div class="constraint"><p class="prefix"><a name="wf-Legalchar"></a><b>Well-formedness constraint: Legal Character</b></p><p>Characters referred
|
||||||
to using character references must match the production for <a title="" href="#NT-Char">Char</a>.</p>
|
to using character references must match the production for <a title="" href="#NT-Char">Char</a>.</p>
|
||||||
</div>
|
</div>
|
||||||
<p>If the character reference begins with "<code>&#x</code>",
|
<p>If the character reference begins with "<code>&#x</code>",
|
||||||
the digits and letters up to the terminating <code>;</code> provide a hexadecimal
|
the digits and letters up to the terminating <code>;</code> provide a hexadecimal
|
||||||
representation of the character's code point in ISO/IEC 10646. If it begins
|
representation of the character's code point in ISO/IEC 10646. If it begins
|
||||||
just with "<code>&#</code>", the digits up to the terminating <code>;</code>
|
just with "<code>&#</code>", the digits up to the terminating <code>;</code>
|
||||||
provide a decimal representation of the character's code point.</p>
|
provide a decimal representation of the character's code point.</p>
|
||||||
<p>[<a name="dt-entref" title="Entity Reference">Definition</a>: An <b>entity reference</b>
|
<p>[<a name="dt-entref" title="Entity Reference">Definition</a>: An <b>entity reference</b>
|
||||||
refers to the content of a named entity.] [<a name="dt-GERef" title="General Entity Reference">Definition</a>: References to parsed general entities use
|
refers to the content of a named entity.] [<a name="dt-GERef" title="General Entity Reference">Definition</a>: References to parsed general entities use
|
||||||
@ -1280,7 +1280,7 @@ use percent-sign (<code>%</code>) and semicolon (<code>;</code>) as delimiters.]
|
|||||||
<h5>Entity Reference</h5><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td><a name="NT-Reference"></a>[67]<5D><><EFBFBD></td><td><code>Reference</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code><a href="#NT-EntityRef">EntityRef</a> | <a href="#NT-CharRef">CharRef</a></code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-EntityRef"></a>[68]<5D><><EFBFBD></td><td><code>EntityRef</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'&' <a href="#NT-Name">Name</a> ';'</code></td><xsltdebug></xsltdebug><td><a href="#wf-entdeclared">[WFC: Entity Declared]</a></td></tr><tr valign="baseline"><td></td><td></td><td></td><td></td><td><a href="#vc-entdeclared">[VC: Entity Declared]</a></td></tr><tr valign="baseline"><td></td><td></td><td></td><td></td><td><a href="#textent">[WFC: Parsed Entity]</a></td></tr><tr valign="baseline"><td></td><td></td><td></td><td></td><td><a href="#norecursion">[WFC: No Recursion]</a></td></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-PEReference"></a>[69]<5D><><EFBFBD></td><td><code>PEReference</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'%' <a href="#NT-Name">Name</a> ';'</code></td><xsltdebug></xsltdebug><td><a href="#vc-entdeclared">[VC: Entity Declared]</a></td></tr><tr valign="baseline"><td></td><td></td><td></td><td></td><td><a href="#norecursion">[WFC: No Recursion]</a></td></tr><tr valign="baseline"><td></td><td></td><td></td><td></td><td><a href="#indtd">[WFC: In DTD]</a></td></tr></tbody></table>
|
<h5>Entity Reference</h5><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td><a name="NT-Reference"></a>[67]<5D><><EFBFBD></td><td><code>Reference</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code><a href="#NT-EntityRef">EntityRef</a> | <a href="#NT-CharRef">CharRef</a></code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-EntityRef"></a>[68]<5D><><EFBFBD></td><td><code>EntityRef</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'&' <a href="#NT-Name">Name</a> ';'</code></td><xsltdebug></xsltdebug><td><a href="#wf-entdeclared">[WFC: Entity Declared]</a></td></tr><tr valign="baseline"><td></td><td></td><td></td><td></td><td><a href="#vc-entdeclared">[VC: Entity Declared]</a></td></tr><tr valign="baseline"><td></td><td></td><td></td><td></td><td><a href="#textent">[WFC: Parsed Entity]</a></td></tr><tr valign="baseline"><td></td><td></td><td></td><td></td><td><a href="#norecursion">[WFC: No Recursion]</a></td></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-PEReference"></a>[69]<5D><><EFBFBD></td><td><code>PEReference</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>'%' <a href="#NT-Name">Name</a> ';'</code></td><xsltdebug></xsltdebug><td><a href="#vc-entdeclared">[VC: Entity Declared]</a></td></tr><tr valign="baseline"><td></td><td></td><td></td><td></td><td><a href="#norecursion">[WFC: No Recursion]</a></td></tr><tr valign="baseline"><td></td><td></td><td></td><td></td><td><a href="#indtd">[WFC: In DTD]</a></td></tr></tbody></table>
|
||||||
<div class="constraint"><p class="prefix"><a name="wf-entdeclared"></a><b>Well-formedness constraint: Entity Declared</b></p><p>In a document
|
<div class="constraint"><p class="prefix"><a name="wf-entdeclared"></a><b>Well-formedness constraint: Entity Declared</b></p><p>In a document
|
||||||
without any DTD, a document with only an internal DTD subset which contains
|
without any DTD, a document with only an internal DTD subset which contains
|
||||||
no parameter entity references, or a document with "<code>standalone='yes'</code>", for
|
no parameter entity references, or a document with "<code>standalone='yes'</code>", for
|
||||||
an entity reference that does not occur within the external subset or a parameter
|
an entity reference that does not occur within the external subset or a parameter
|
||||||
entity, the <a href="#NT-Name">Name</a> given in the entity reference must <a title="match" href="#dt-match">match</a> that in an <a href="#sec-entity-decl"><cite>entity
|
entity, the <a href="#NT-Name">Name</a> given in the entity reference must <a title="match" href="#dt-match">match</a> that in an <a href="#sec-entity-decl"><cite>entity
|
||||||
declaration</cite></a> that does not occur within the external subset or a
|
declaration</cite></a> that does not occur within the external subset or a
|
||||||
@ -1299,7 +1299,7 @@ the rule that an entity must be declared is a well-formedness constraint only
|
|||||||
if <a href="#sec-rmd"><cite>standalone='yes'</cite></a>.</p>
|
if <a href="#sec-rmd"><cite>standalone='yes'</cite></a>.</p>
|
||||||
</div>
|
</div>
|
||||||
<div class="constraint"><p class="prefix"><a name="vc-entdeclared"></a><b>Validity constraint: Entity Declared</b></p><p>In a document with
|
<div class="constraint"><p class="prefix"><a name="vc-entdeclared"></a><b>Validity constraint: Entity Declared</b></p><p>In a document with
|
||||||
an external subset or external parameter entities with "<code>standalone='no'</code>",
|
an external subset or external parameter entities with "<code>standalone='no'</code>",
|
||||||
the <a href="#NT-Name">Name</a> given in the entity reference must <a title="match" href="#dt-match">match</a> that in an <a href="#sec-entity-decl"><cite>entity
|
the <a href="#NT-Name">Name</a> given in the entity reference must <a title="match" href="#dt-match">match</a> that in an <a href="#sec-entity-decl"><cite>entity
|
||||||
declaration</cite></a>. For interoperability, valid documents should declare
|
declaration</cite></a>. For interoperability, valid documents should declare
|
||||||
the entities <code>amp</code>,
|
the entities <code>amp</code>,
|
||||||
@ -1329,9 +1329,9 @@ only appear in the <a title="Document Type Declaration" href="#dt-doctype">DTD</
|
|||||||
This document was prepared on &docdate; and
|
This document was prepared on &docdate; and
|
||||||
is classified &security-level;.</pre></td></tr></table>
|
is classified &security-level;.</pre></td></tr></table>
|
||||||
<p>Example of a parameter-entity reference:</p>
|
<p>Example of a parameter-entity reference:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!-- declare the parameter entity "ISOLat2"... -->
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!-- declare the parameter entity "ISOLat2"... -->
|
||||||
<!ENTITY % ISOLat2
|
<!ENTITY % ISOLat2
|
||||||
SYSTEM "http://www.xml.com/iso/isolat2-xml.entities" >
|
SYSTEM "http://www.xml.com/iso/isolat2-xml.entities" >
|
||||||
<!-- ... now reference it. -->
|
<!-- ... now reference it. -->
|
||||||
%ISOLat2;</pre></td></tr></table>
|
%ISOLat2;</pre></td></tr></table>
|
||||||
</div>
|
</div>
|
||||||
@ -1366,8 +1366,8 @@ Note that some processing of entity and character references in the <a title="Li
|
|||||||
the correct <a title="Replacement Text" href="#dt-repltext">replacement text</a>: see <a href="#intern-replacement"><b>4.5 Construction of Internal Entity Replacement Text</b></a>.</p>
|
the correct <a title="Replacement Text" href="#dt-repltext">replacement text</a>: see <a href="#intern-replacement"><b>4.5 Construction of Internal Entity Replacement Text</b></a>.</p>
|
||||||
<p>An internal entity is a <a title="Text Entity" href="#dt-parsedent">parsed entity</a>.</p>
|
<p>An internal entity is a <a title="Text Entity" href="#dt-parsedent">parsed entity</a>.</p>
|
||||||
<p>Example of an internal entity declaration:</p>
|
<p>Example of an internal entity declaration:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY Pub-Status "This is a pre-release of the
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY Pub-Status "This is a pre-release of the
|
||||||
specification."></pre></td></tr></table>
|
specification."></pre></td></tr></table>
|
||||||
</div>
|
</div>
|
||||||
<div class="div3">
|
<div class="div3">
|
||||||
|
|
||||||
@ -1422,12 +1422,12 @@ single space characters (#x20), and leading and trailing white space must
|
|||||||
be removed.</p>
|
be removed.</p>
|
||||||
<p>Examples of external entity declarations:</p>
|
<p>Examples of external entity declarations:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY open-hatch
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY open-hatch
|
||||||
SYSTEM "http://www.textuality.com/boilerplate/OpenHatch.xml">
|
SYSTEM "http://www.textuality.com/boilerplate/OpenHatch.xml">
|
||||||
<!ENTITY open-hatch
|
<!ENTITY open-hatch
|
||||||
PUBLIC "-//Textuality//TEXT Standard open-hatch boilerplate//EN"
|
PUBLIC "-//Textuality//TEXT Standard open-hatch boilerplate//EN"
|
||||||
"http://www.textuality.com/boilerplate/OpenHatch.xml">
|
"http://www.textuality.com/boilerplate/OpenHatch.xml">
|
||||||
<!ENTITY hatch-pic
|
<!ENTITY hatch-pic
|
||||||
SYSTEM "../grafix/OpenHatch.gif"
|
SYSTEM "../grafix/OpenHatch.gif"
|
||||||
NDATA gif ></pre></td></tr></table>
|
NDATA gif ></pre></td></tr></table>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
@ -1469,8 +1469,8 @@ can begin in one entity and end in another.</p>
|
|||||||
<h4><a name="charencoding"></a>4.3.3 Character Encoding in Entities</h4>
|
<h4><a name="charencoding"></a>4.3.3 Character Encoding in Entities</h4>
|
||||||
<p>Each external parsed entity in an XML document may use a different encoding
|
<p>Each external parsed entity in an XML document may use a different encoding
|
||||||
for its characters. All XML processors must be able to read entities in both
|
for its characters. All XML processors must be able to read entities in both
|
||||||
the UTF-8 and UTF-16 encodings. The terms "UTF-8"
|
the UTF-8 and UTF-16 encodings. The terms "UTF-8"
|
||||||
and "UTF-16" in this specification do not apply to character
|
and "UTF-16" in this specification do not apply to character
|
||||||
encodings with any other labels, even if the encodings or labels are very
|
encodings with any other labels, even if the encodings or labels are very
|
||||||
similar to UTF-8 or UTF-16.</p>
|
similar to UTF-8 or UTF-16.</p>
|
||||||
<p>Entities encoded in UTF-16 must begin with the Byte Order Mark described
|
<p>Entities encoded in UTF-16 must begin with the Byte Order Mark described
|
||||||
@ -1491,25 +1491,25 @@ must begin with a text declaration (see <a href="#sec-TextDecl"><b>4.3.1 The Tex
|
|||||||
an encoding declaration:</p>
|
an encoding declaration:</p>
|
||||||
|
|
||||||
<h5>Encoding Declaration</h5><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td><a name="NT-EncodingDecl"></a>[80]<5D><><EFBFBD></td><td><code>EncodingDecl</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code><a href="#NT-S">S</a> 'encoding' <a href="#NT-Eq">Eq</a>
|
<h5>Encoding Declaration</h5><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td><a name="NT-EncodingDecl"></a>[80]<5D><><EFBFBD></td><td><code>EncodingDecl</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code><a href="#NT-S">S</a> 'encoding' <a href="#NT-Eq">Eq</a>
|
||||||
('"' <a href="#NT-EncName">EncName</a> '"' | "'" <a href="#NT-EncName">EncName</a>
|
('"' <a href="#NT-EncName">EncName</a> '"' | "'" <a href="#NT-EncName">EncName</a>
|
||||||
"'" ) </code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-EncName"></a>[81]<5D><><EFBFBD></td><td><code>EncName</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>[A-Za-z] ([A-Za-z0-9._] | '-')*</code></td><xsltdebug></xsltdebug><td><i>/* Encoding
|
"'" ) </code></td><xsltdebug></xsltdebug></tr></tbody><tbody><tr valign="baseline"><td><a name="NT-EncName"></a>[81]<5D><><EFBFBD></td><td><code>EncName</code></td><td><EFBFBD><EFBFBD><EFBFBD>::=<3D><><EFBFBD></td><td><code>[A-Za-z] ([A-Za-z0-9._] | '-')*</code></td><xsltdebug></xsltdebug><td><i>/* Encoding
|
||||||
name contains only Latin characters */</i></td></tr></tbody></table>
|
name contains only Latin characters */</i></td></tr></tbody></table>
|
||||||
<p>In the <a title="Document Entity" href="#dt-docent">document entity</a>, the encoding
|
<p>In the <a title="Document Entity" href="#dt-docent">document entity</a>, the encoding
|
||||||
declaration is part of the <a title="XML Declaration" href="#dt-xmldecl">XML declaration</a>.
|
declaration is part of the <a title="XML Declaration" href="#dt-xmldecl">XML declaration</a>.
|
||||||
The <a href="#NT-EncName">EncName</a> is the name of the encoding used.</p>
|
The <a href="#NT-EncName">EncName</a> is the name of the encoding used.</p>
|
||||||
|
|
||||||
<p>In an encoding declaration, the values "<code>UTF-8</code>", "<code>UTF-16</code>", "<code>ISO-10646-UCS-2</code>", and "<code>ISO-10646-UCS-4</code>" should be used
|
<p>In an encoding declaration, the values "<code>UTF-8</code>", "<code>UTF-16</code>", "<code>ISO-10646-UCS-2</code>", and "<code>ISO-10646-UCS-4</code>" should be used
|
||||||
for the various encodings and transformations of Unicode / ISO/IEC 10646,
|
for the various encodings and transformations of Unicode / ISO/IEC 10646,
|
||||||
the values "<code>ISO-8859-1</code>", "<code>ISO-8859-2</code>",
|
the values "<code>ISO-8859-1</code>", "<code>ISO-8859-2</code>",
|
||||||
... "<code>ISO-8859-</code><var>n</var>" (where <var>n</var>
|
... "<code>ISO-8859-</code><var>n</var>" (where <var>n</var>
|
||||||
is the part number) should be used for the parts of ISO 8859, and
|
is the part number) should be used for the parts of ISO 8859, and
|
||||||
the values "<code>ISO-2022-JP</code>", "<code>Shift_JIS</code>",
|
the values "<code>ISO-2022-JP</code>", "<code>Shift_JIS</code>",
|
||||||
and "<code>EUC-JP</code>" should be used for the various encoded
|
and "<code>EUC-JP</code>" should be used for the various encoded
|
||||||
forms of JIS X-0208-1997. It
|
forms of JIS X-0208-1997. It
|
||||||
is recommended that character encodings registered (as <em>charset</em>s)
|
is recommended that character encodings registered (as <em>charset</em>s)
|
||||||
with the Internet Assigned Numbers Authority <a href="#IANA">[IANA-CHARSETS]</a>,
|
with the Internet Assigned Numbers Authority <a href="#IANA">[IANA-CHARSETS]</a>,
|
||||||
other than those just listed, be referred to using their registered names;
|
other than those just listed, be referred to using their registered names;
|
||||||
other encodings should use names starting with an "x-" prefix.
|
other encodings should use names starting with an "x-" prefix.
|
||||||
XML processors should match character encoding names in a case-insensitive
|
XML processors should match character encoding names in a case-insensitive
|
||||||
way and should either interpret an IANA-registered name as the encoding registered
|
way and should either interpret an IANA-registered name as the encoding registered
|
||||||
at IANA for that name or treat it as unknown (processors are, of course, not
|
at IANA for that name or treat it as unknown (processors are, of course, not
|
||||||
@ -1613,8 +1613,8 @@ and processed, in place of the reference itself, as though it were part of
|
|||||||
the document at the location the reference was recognized.] The replacement
|
the document at the location the reference was recognized.] The replacement
|
||||||
text may contain both <a title="Character Data" href="#dt-chardata">character data</a>
|
text may contain both <a title="Character Data" href="#dt-chardata">character data</a>
|
||||||
and (except for parameter entities) <a title="Markup" href="#dt-markup">markup</a>,
|
and (except for parameter entities) <a title="Markup" href="#dt-markup">markup</a>,
|
||||||
which must be recognized in the usual way. (The string "<code>AT&amp;T;</code>"
|
which must be recognized in the usual way. (The string "<code>AT&amp;T;</code>"
|
||||||
expands to "<code>AT&T;</code>" and the remaining ampersand
|
expands to "<code>AT&T;</code>" and the remaining ampersand
|
||||||
is not recognized as an entity-reference delimiter.) A character reference
|
is not recognized as an entity-reference delimiter.) A character reference
|
||||||
is <b>included</b> when the indicated character is processed in place
|
is <b>included</b> when the indicated character is processed in place
|
||||||
of the reference itself. </p>
|
of the reference itself. </p>
|
||||||
@ -1662,10 +1662,10 @@ the location the reference was recognized, except that a single or double
|
|||||||
quote character in the replacement text is always treated as a normal data
|
quote character in the replacement text is always treated as a normal data
|
||||||
character and will not terminate the literal. For example, this is well-formed:</p>
|
character and will not terminate the literal. For example, this is well-formed:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!-- -->
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!-- -->
|
||||||
<!ENTITY % YN '"Yes"' >
|
<!ENTITY % YN '"Yes"' >
|
||||||
<!ENTITY WhatHeSaid "He said %YN;" ></pre></td></tr></table>
|
<!ENTITY WhatHeSaid "He said %YN;" ></pre></td></tr></table>
|
||||||
<p>while this is not:</p>
|
<p>while this is not:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY EndAttr "27'" >
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY EndAttr "27'" >
|
||||||
<element attribute='a-&EndAttr;></pre></td></tr></table>
|
<element attribute='a-&EndAttr;></pre></td></tr></table>
|
||||||
</div>
|
</div>
|
||||||
<div class="div3">
|
<div class="div3">
|
||||||
@ -1712,16 +1712,16 @@ text</em> of any parameter entities referred to, and must contain the character
|
|||||||
referred to, in place of any character references in the literal entity value;
|
referred to, in place of any character references in the literal entity value;
|
||||||
however, general-entity references must be left as-is, unexpanded. For example,
|
however, general-entity references must be left as-is, unexpanded. For example,
|
||||||
given the following declarations:</p>
|
given the following declarations:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY % pub "&#xc9;ditions Gallimard" >
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY % pub "&#xc9;ditions Gallimard" >
|
||||||
<!ENTITY rights "All rights reserved" >
|
<!ENTITY rights "All rights reserved" >
|
||||||
<!ENTITY book "La Peste: Albert Camus,
|
<!ENTITY book "La Peste: Albert Camus,
|
||||||
&#xA9; 1947 %pub;. &rights;" ></pre></td></tr></table>
|
&#xA9; 1947 %pub;. &rights;" ></pre></td></tr></table>
|
||||||
<p>then the replacement text for the entity "<code>book</code>"
|
<p>then the replacement text for the entity "<code>book</code>"
|
||||||
is:</p>
|
is:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre>La Peste: Albert Camus,
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre>La Peste: Albert Camus,
|
||||||
<EFBFBD> 1947 <20>ditions Gallimard. &rights;</pre></td></tr></table>
|
<EFBFBD> 1947 <20>ditions Gallimard. &rights;</pre></td></tr></table>
|
||||||
<p>The general-entity reference "<code>&rights;</code>" would
|
<p>The general-entity reference "<code>&rights;</code>" would
|
||||||
be expanded should the reference "<code>&book;</code>" appear
|
be expanded should the reference "<code>&book;</code>" appear
|
||||||
in the document's content or an attribute value.</p>
|
in the document's content or an attribute value.</p>
|
||||||
<p>These simple rules may have complex interactions; for a detailed discussion
|
<p>These simple rules may have complex interactions; for a detailed discussion
|
||||||
of a difficult example, see <a href="#sec-entexpand"><b>D Expansion of Entity and Character References</b></a>.</p>
|
of a difficult example, see <a href="#sec-entexpand"><b>D Expansion of Entity and Character References</b></a>.</p>
|
||||||
@ -1738,7 +1738,7 @@ other delimiters. A set of general entities (<code>amp</code>,
|
|||||||
<code>quot</code>) is specified for
|
<code>quot</code>) is specified for
|
||||||
this purpose. Numeric character references may also be used; they are expanded
|
this purpose. Numeric character references may also be used; they are expanded
|
||||||
immediately when recognized and must be treated as character data, so the
|
immediately when recognized and must be treated as character data, so the
|
||||||
numeric character references "<code>&#60;</code>" and "<code>&#38;</code>"
|
numeric character references "<code>&#60;</code>" and "<code>&#38;</code>"
|
||||||
may be used to escape <code><</code> and <code>&</code> when they occur
|
may be used to escape <code><</code> and <code>&</code> when they occur
|
||||||
in character data.]</p>
|
in character data.]</p>
|
||||||
<p>All XML processors must recognize these entities whether they are declared
|
<p>All XML processors must recognize these entities whether they are declared
|
||||||
@ -1754,11 +1754,11 @@ or <code>quot</code> are declared, they must be declared as internal entities
|
|||||||
whose replacement text is the single character being escaped (or a character
|
whose replacement text is the single character being escaped (or a character
|
||||||
reference to that character; the double escaping here is unnecessary but harmless).
|
reference to that character; the double escaping here is unnecessary but harmless).
|
||||||
For example:</p>
|
For example:</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY lt "&#38;#60;">
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY lt "&#38;#60;">
|
||||||
<!ENTITY gt "&#62;">
|
<!ENTITY gt "&#62;">
|
||||||
<!ENTITY amp "&#38;#38;">
|
<!ENTITY amp "&#38;#38;">
|
||||||
<!ENTITY apos "&#39;">
|
<!ENTITY apos "&#39;">
|
||||||
<!ENTITY quot "&#34;"></pre></td></tr></table>
|
<!ENTITY quot "&#34;"></pre></td></tr></table>
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
<div class="div2">
|
<div class="div2">
|
||||||
@ -1827,7 +1827,7 @@ they do <em>not</em> read; that is to say, they must use the information
|
|||||||
in those declarations to <a href="#AVNormalize"><cite>normalize</cite></a>
|
in those declarations to <a href="#AVNormalize"><cite>normalize</cite></a>
|
||||||
attribute values, <a href="#included"><cite>include</cite></a> the replacement
|
attribute values, <a href="#included"><cite>include</cite></a> the replacement
|
||||||
text of internal entities, and supply <a href="#sec-attr-defaults"><cite>default
|
text of internal entities, and supply <a href="#sec-attr-defaults"><cite>default
|
||||||
attribute values</cite></a>.] Except when <code>standalone="yes"</code>, they
|
attribute values</cite></a>.] Except when <code>standalone="yes"</code>, they
|
||||||
must not <a title="Process Declarations" href="#dt-use-mdecl">process</a> <a title="entity declaration" href="#dt-entdecl">entity
|
must not <a title="Process Declarations" href="#dt-use-mdecl">process</a> <a title="entity declaration" href="#dt-entdecl">entity
|
||||||
declarations</a> or <a title="Attribute-List Declaration" href="#dt-attdecl">attribute-list declarations</a>
|
declarations</a> or <a title="Attribute-List Declaration" href="#dt-attdecl">attribute-list declarations</a>
|
||||||
encountered after a reference to a parameter entity that is not read, since
|
encountered after a reference to a parameter entity that is not read, since
|
||||||
@ -1901,7 +1901,7 @@ indicated.</p>
|
|||||||
<p>matches any <a href="#NT-Char">Char</a> with a value not among the characters given. Enumerations
|
<p>matches any <a href="#NT-Char">Char</a> with a value not among the characters given. Enumerations
|
||||||
and ranges of forbidden values can be mixed in one set of brackets.</p>
|
and ranges of forbidden values can be mixed in one set of brackets.</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt class="label"><code>"string"</code></dt>
|
<dt class="label"><code>"string"</code></dt>
|
||||||
<dd>
|
<dd>
|
||||||
<p>matches a literal string <a title="match" href="#dt-match">matching</a> that
|
<p>matches a literal string <a title="match" href="#dt-match">matching</a> that
|
||||||
given inside the double quotes.</p>
|
given inside the double quotes.</p>
|
||||||
@ -2177,8 +2177,8 @@ the categories Mc, Me, Mn, Lm, or Nd.</p></li>
|
|||||||
<li><p>Characters in the compatibility area (i.e. with character code greater
|
<li><p>Characters in the compatibility area (i.e. with character code greater
|
||||||
than #xF900 and less than #xFFFE) are not allowed in XML names.</p></li>
|
than #xF900 and less than #xFFFE) are not allowed in XML names.</p></li>
|
||||||
<li><p>Characters which have a font or compatibility decomposition (i.e.
|
<li><p>Characters which have a font or compatibility decomposition (i.e.
|
||||||
those with a "compatibility formatting tag" in field 5 of the
|
those with a "compatibility formatting tag" in field 5 of the
|
||||||
database -- marked by field 5 beginning with a "<") are not
|
database -- marked by field 5 beginning with a "<") are not
|
||||||
allowed.</p></li>
|
allowed.</p></li>
|
||||||
<li><p>The following characters are treated as name-start characters rather
|
<li><p>The following characters are treated as name-start characters rather
|
||||||
than name characters, because the property file classifies them as Alphabetic:
|
than name characters, because the property file classifies them as Alphabetic:
|
||||||
@ -2208,16 +2208,16 @@ restrictions that XML places on documents beyond those of SGML, see <a href="#Cl
|
|||||||
<p>This appendix contains some examples illustrating the sequence of entity-
|
<p>This appendix contains some examples illustrating the sequence of entity-
|
||||||
and character-reference recognition and expansion, as specified in <a href="#entproc"><b>4.4 XML Processor Treatment of Entities and References</b></a>.</p>
|
and character-reference recognition and expansion, as specified in <a href="#entproc"><b>4.4 XML Processor Treatment of Entities and References</b></a>.</p>
|
||||||
<p>If the DTD contains the declaration</p>
|
<p>If the DTD contains the declaration</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY example "<p>An ampersand (&#38;#38;) may be escaped
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><!ENTITY example "<p>An ampersand (&#38;#38;) may be escaped
|
||||||
numerically (&#38;#38;#38;) or with a general entity
|
numerically (&#38;#38;#38;) or with a general entity
|
||||||
(&amp;amp;).</p>" ></pre></td></tr></table>
|
(&amp;amp;).</p>" ></pre></td></tr></table>
|
||||||
<p>then the XML processor will recognize the character references when it
|
<p>then the XML processor will recognize the character references when it
|
||||||
parses the entity declaration, and resolve them before storing the following
|
parses the entity declaration, and resolve them before storing the following
|
||||||
string as the value of the entity "<code>example</code>":</p>
|
string as the value of the entity "<code>example</code>":</p>
|
||||||
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><p>An ampersand (&#38;) may be escaped
|
<table class="eg" cellpadding="5" border="1" bgcolor="#99ffff" width="100%" summary="Example"><tr><td><pre><p>An ampersand (&#38;) may be escaped
|
||||||
numerically (&#38;#38;) or with a general entity
|
numerically (&#38;#38;) or with a general entity
|
||||||
(&amp;amp;).</p></pre></td></tr></table>
|
(&amp;amp;).</p></pre></td></tr></table>
|
||||||
<p>A reference in the document to "<code>&example;</code>"
|
<p>A reference in the document to "<code>&example;</code>"
|
||||||
will cause the text to be reparsed, at which time the start- and end-tags
|
will cause the text to be reparsed, at which time the start- and end-tags
|
||||||
of the <code>p</code> element will be recognized and the three references will
|
of the <code>p</code> element will be recognized and the three references will
|
||||||
be recognized and expanded, resulting in a <code>p</code> element with the following
|
be recognized and expanded, resulting in a <code>p</code> element with the following
|
||||||
@ -2231,30 +2231,30 @@ In the following example, the line numbers are solely for reference.</p>
|
|||||||
2 <!DOCTYPE test [
|
2 <!DOCTYPE test [
|
||||||
3 <!ELEMENT test (#PCDATA) >
|
3 <!ELEMENT test (#PCDATA) >
|
||||||
4 <!ENTITY % xx '&#37;zz;'>
|
4 <!ENTITY % xx '&#37;zz;'>
|
||||||
5 <!ENTITY % zz '&#60;!ENTITY tricky "error-prone" >' >
|
5 <!ENTITY % zz '&#60;!ENTITY tricky "error-prone" >' >
|
||||||
6 %xx;
|
6 %xx;
|
||||||
7 ]>
|
7 ]>
|
||||||
8 <test>This sample shows a &tricky; method.</test></pre></td></tr></table>
|
8 <test>This sample shows a &tricky; method.</test></pre></td></tr></table>
|
||||||
<p>This produces the following:</p>
|
<p>This produces the following:</p>
|
||||||
<ul>
|
<ul>
|
||||||
<li><p>in line 4, the reference to character 37 is expanded immediately,
|
<li><p>in line 4, the reference to character 37 is expanded immediately,
|
||||||
and the parameter entity "<code>xx</code>" is stored in the symbol
|
and the parameter entity "<code>xx</code>" is stored in the symbol
|
||||||
table with the value "<code>%zz;</code>". Since the replacement
|
table with the value "<code>%zz;</code>". Since the replacement
|
||||||
text is not rescanned, the reference to parameter entity "<code>zz</code>"
|
text is not rescanned, the reference to parameter entity "<code>zz</code>"
|
||||||
is not recognized. (And it would be an error if it were, since "<code>zz</code>"
|
is not recognized. (And it would be an error if it were, since "<code>zz</code>"
|
||||||
is not yet declared.)</p></li>
|
is not yet declared.)</p></li>
|
||||||
<li><p>in line 5, the character reference "<code>&#60;</code>"
|
<li><p>in line 5, the character reference "<code>&#60;</code>"
|
||||||
is expanded immediately and the parameter entity "<code>zz</code>"
|
is expanded immediately and the parameter entity "<code>zz</code>"
|
||||||
is stored with the replacement text "<code><!ENTITY tricky "error-prone"
|
is stored with the replacement text "<code><!ENTITY tricky "error-prone"
|
||||||
></code>", which is a well-formed entity declaration.</p></li>
|
></code>", which is a well-formed entity declaration.</p></li>
|
||||||
<li><p>in line 6, the reference to "<code>xx</code>" is recognized,
|
<li><p>in line 6, the reference to "<code>xx</code>" is recognized,
|
||||||
and the replacement text of "<code>xx</code>" (namely "<code>%zz;</code>")
|
and the replacement text of "<code>xx</code>" (namely "<code>%zz;</code>")
|
||||||
is parsed. The reference to "<code>zz</code>" is recognized in
|
is parsed. The reference to "<code>zz</code>" is recognized in
|
||||||
its turn, and its replacement text ("<code><!ENTITY tricky "error-prone"
|
its turn, and its replacement text ("<code><!ENTITY tricky "error-prone"
|
||||||
></code>") is parsed. The general entity "<code>tricky</code>"
|
></code>") is parsed. The general entity "<code>tricky</code>"
|
||||||
has now been declared, with the replacement text "<code>error-prone</code>".</p>
|
has now been declared, with the replacement text "<code>error-prone</code>".</p>
|
||||||
</li>
|
</li>
|
||||||
<li><p>in line 8, the reference to the general entity "<code>tricky</code>"
|
<li><p>in line 8, the reference to the general entity "<code>tricky</code>"
|
||||||
is recognized, and it is expanded, so the full content of the <code>test</code>
|
is recognized, and it is expanded, so the full content of the <code>test</code>
|
||||||
element is the self-describing (and ungrammatical) string <em>This sample
|
element is the self-describing (and ungrammatical) string <em>This sample
|
||||||
shows a error-prone method.</em></p></li>
|
shows a error-prone method.</em></p></li>
|
||||||
@ -2266,7 +2266,7 @@ shows a error-prone method.</em></p></li>
|
|||||||
<p>As
|
<p>As
|
||||||
noted in <a href="#sec-element-content"><b>3.2.1 Element Content</b></a>, it is required that content
|
noted in <a href="#sec-element-content"><b>3.2.1 Element Content</b></a>, it is required that content
|
||||||
models in element type declarations be deterministic. This requirement is <a title="For Compatibility" href="#dt-compat">for compatibility</a> with SGML (which calls deterministic
|
models in element type declarations be deterministic. This requirement is <a title="For Compatibility" href="#dt-compat">for compatibility</a> with SGML (which calls deterministic
|
||||||
content models "unambiguous"); XML processors built
|
content models "unambiguous"); XML processors built
|
||||||
using SGML systems may flag non-deterministic content models as errors.</p>
|
using SGML systems may flag non-deterministic content models as errors.</p>
|
||||||
<p>For example, the content model <code>((b, c) | (b, d))</code> is non-deterministic,
|
<p>For example, the content model <code>((b, c) | (b, d))</code> is non-deterministic,
|
||||||
because given an initial <code>b</code> the XML processor
|
because given an initial <code>b</code> the XML processor
|
||||||
@ -2314,9 +2314,9 @@ encoding information and not in UTF-8 or UTF-16 encoding <em>must</em>
|
|||||||
begin with an XML encoding declaration, in which the first characters must
|
begin with an XML encoding declaration, in which the first characters must
|
||||||
be '<code><?xml</code>', any conforming processor can detect, after two
|
be '<code><?xml</code>', any conforming processor can detect, after two
|
||||||
to four octets of input, which of the following cases apply. In reading this
|
to four octets of input, which of the following cases apply. In reading this
|
||||||
list, it may help to know that in UCS-4, '<' is "<code>#x0000003C</code>"
|
list, it may help to know that in UCS-4, '<' is "<code>#x0000003C</code>"
|
||||||
and '?' is "<code>#x0000003F</code>", and the Byte Order Mark
|
and '?' is "<code>#x0000003F</code>", and the Byte Order Mark
|
||||||
required of UTF-16 data streams is "<code>#xFEFF</code>". The notation <var>##</var> is used to denote any byte value except that two consecutive <var>##</var>s cannot be both 00.</p>
|
required of UTF-16 data streams is "<code>#xFEFF</code>". The notation <var>##</var> is used to denote any byte value except that two consecutive <var>##</var>s cannot be both 00.</p>
|
||||||
<p>With a Byte Order Mark:</p>
|
<p>With a Byte Order Mark:</p>
|
||||||
<table border="1" frame="border"><tbody><tr><td colspan="1" rowspan="1"><code>00 00 FE
|
<table border="1" frame="border"><tbody><tr><td colspan="1" rowspan="1"><code>00 00 FE
|
||||||
FF</code></td><td colspan="1" rowspan="1">UCS-4, big-endian machine (1234 order)</td></tr><tr><td colspan="1" rowspan="1"><code>FF
|
FF</code></td><td colspan="1" rowspan="1">UCS-4, big-endian machine (1234 order)</td></tr><tr><td colspan="1" rowspan="1"><code>FF
|
||||||
@ -2484,7 +2484,7 @@ Contact</i>) </li>
|
|||||||
</div>
|
</div>
|
||||||
<div class="div1">
|
<div class="div1">
|
||||||
|
|
||||||
<h2><a name="id2676581"></a>I Production Notes (Non-Normative)</h2>
|
<h2><a name="id2681697"></a>I Production Notes (Non-Normative)</h2>
|
||||||
<p>This Second Edition was encoded in the <a href="http://www.w3.org/XML/1998/06/xmlspec-v21.dtd">XMLspec
|
<p>This Second Edition was encoded in the <a href="http://www.w3.org/XML/1998/06/xmlspec-v21.dtd">XMLspec
|
||||||
DTD</a> (which has <a href="http://www.w3.org/XML/1998/06/xmlspec-report-v21.htm">documentation</a>
|
DTD</a> (which has <a href="http://www.w3.org/XML/1998/06/xmlspec-report-v21.htm">documentation</a>
|
||||||
available). The HTML versions were produced with a combination of the <a href="http://www.w3.org/XML/1998/06/xmlspec.xsl">xmlspec.xsl</a>, <a href="http://www.w3.org/XML/1998/06/diffspec.xsl">diffspec.xsl</a>,
|
available). The HTML versions were produced with a combination of the <a href="http://www.w3.org/XML/1998/06/xmlspec.xsl">xmlspec.xsl</a>, <a href="http://www.w3.org/XML/1998/06/diffspec.xsl">diffspec.xsl</a>,
|
||||||
|
|||||||
@ -118,7 +118,7 @@ static xmlChar *strparams[MAX_PARAMETERS + 1];
|
|||||||
static int nbstrparams = 0;
|
static int nbstrparams = 0;
|
||||||
static xmlChar *paths[MAX_PATHS + 1];
|
static xmlChar *paths[MAX_PATHS + 1];
|
||||||
static int nbpaths = 0;
|
static int nbpaths = 0;
|
||||||
static const char *output = NULL;
|
static char *output = NULL;
|
||||||
static int errorno = 0;
|
static int errorno = 0;
|
||||||
static const char *writesubtree = NULL;
|
static const char *writesubtree = NULL;
|
||||||
|
|
||||||
@ -555,7 +555,7 @@ main(int argc, char **argv)
|
|||||||
output = xmlCanonicPath(argv[i]);
|
output = xmlCanonicPath(argv[i]);
|
||||||
if (output == NULL)
|
if (output == NULL)
|
||||||
#endif
|
#endif
|
||||||
output = xmlStrdup(argv[i]);
|
output = (char *) xmlStrdup((xmlChar *) argv[i]);
|
||||||
} else if ((!strcmp(argv[i], "-V")) ||
|
} else if ((!strcmp(argv[i], "-V")) ||
|
||||||
(!strcmp(argv[i], "-version")) ||
|
(!strcmp(argv[i], "-version")) ||
|
||||||
(!strcmp(argv[i], "--version"))) {
|
(!strcmp(argv[i], "--version"))) {
|
||||||
|
|||||||
Reference in New Issue
Block a user