Annotation of embedaddon/libxml2/DOCBparser.c, revision 1.1
1.1 ! misho 1: /*
! 2: * DOCBparser.c : an attempt to parse SGML Docbook documents
! 3: *
! 4: * This is deprecated !!!
! 5: * Code removed with release 2.6.0 it was broken.
! 6: * The doc are expect to be migrated to XML DocBook
! 7: *
! 8: * See Copyright for the status of this software.
! 9: *
! 10: * daniel@veillard.com
! 11: */
! 12:
! 13: #define IN_LIBXML
! 14: #include "libxml.h"
! 15: #ifdef LIBXML_DOCB_ENABLED
! 16:
! 17: #include <libxml/xmlerror.h>
! 18: #include <libxml/DOCBparser.h>
! 19:
! 20: /**
! 21: * docbEncodeEntities:
! 22: * @out: a pointer to an array of bytes to store the result
! 23: * @outlen: the length of @out
! 24: * @in: a pointer to an array of UTF-8 chars
! 25: * @inlen: the length of @in
! 26: * @quoteChar: the quote character to escape (' or ") or zero.
! 27: *
! 28: * Take a block of UTF-8 chars in and try to convert it to an ASCII
! 29: * plus SGML entities block of chars out.
! 30: *
! 31: * Returns 0 if success, -2 if the transcoding fails, or -1 otherwise
! 32: * The value of @inlen after return is the number of octets consumed
! 33: * as the return value is positive, else unpredictable.
! 34: * The value of @outlen after return is the number of octets consumed.
! 35: */
! 36: int
! 37: docbEncodeEntities(unsigned char *out ATTRIBUTE_UNUSED,
! 38: int *outlen ATTRIBUTE_UNUSED,
! 39: const unsigned char *in ATTRIBUTE_UNUSED,
! 40: int *inlen ATTRIBUTE_UNUSED,
! 41: int quoteChar ATTRIBUTE_UNUSED)
! 42: {
! 43: static int deprecated = 0;
! 44:
! 45: if (!deprecated) {
! 46: xmlGenericError(xmlGenericErrorContext,
! 47: "docbEncodeEntities() deprecated function reached\n");
! 48: deprecated = 1;
! 49: }
! 50: return(-1);
! 51: }
! 52:
! 53: /**
! 54: * docbParseDocument:
! 55: * @ctxt: an SGML parser context
! 56: *
! 57: * parse an SGML document (and build a tree if using the standard SAX
! 58: * interface).
! 59: *
! 60: * Returns 0, -1 in case of error. the parser context is augmented
! 61: * as a result of the parsing.
! 62: */
! 63:
! 64: int
! 65: docbParseDocument(docbParserCtxtPtr ctxt ATTRIBUTE_UNUSED)
! 66: {
! 67: static int deprecated = 0;
! 68:
! 69: if (!deprecated) {
! 70: xmlGenericError(xmlGenericErrorContext,
! 71: "docbParseDocument() deprecated function reached\n");
! 72: deprecated = 1;
! 73: }
! 74: return (xmlParseDocument(ctxt));
! 75: }
! 76:
! 77: /**
! 78: * docbFreeParserCtxt:
! 79: * @ctxt: an SGML parser context
! 80: *
! 81: * Free all the memory used by a parser context. However the parsed
! 82: * document in ctxt->myDoc is not freed.
! 83: */
! 84:
! 85: void
! 86: docbFreeParserCtxt(docbParserCtxtPtr ctxt ATTRIBUTE_UNUSED)
! 87: {
! 88: static int deprecated = 0;
! 89:
! 90: if (!deprecated) {
! 91: xmlGenericError(xmlGenericErrorContext,
! 92: "docbFreeParserCtxt() deprecated function reached\n");
! 93: deprecated = 1;
! 94: }
! 95: xmlFreeParserCtxt(ctxt);
! 96: }
! 97:
! 98: /**
! 99: * docbParseChunk:
! 100: * @ctxt: an XML parser context
! 101: * @chunk: an char array
! 102: * @size: the size in byte of the chunk
! 103: * @terminate: last chunk indicator
! 104: *
! 105: * Parse a Chunk of memory
! 106: *
! 107: * Returns zero if no error, the xmlParserErrors otherwise.
! 108: */
! 109: int
! 110: docbParseChunk(docbParserCtxtPtr ctxt ATTRIBUTE_UNUSED,
! 111: const char *chunk ATTRIBUTE_UNUSED,
! 112: int size ATTRIBUTE_UNUSED,
! 113: int terminate ATTRIBUTE_UNUSED)
! 114: {
! 115: static int deprecated = 0;
! 116:
! 117: if (!deprecated) {
! 118: xmlGenericError(xmlGenericErrorContext,
! 119: "docbParseChunk() deprecated function reached\n");
! 120: deprecated = 1;
! 121: }
! 122:
! 123: return (xmlParseChunk(ctxt, chunk, size, terminate));
! 124: }
! 125:
! 126: /**
! 127: * docbCreatePushParserCtxt:
! 128: * @sax: a SAX handler
! 129: * @user_data: The user data returned on SAX callbacks
! 130: * @chunk: a pointer to an array of chars
! 131: * @size: number of chars in the array
! 132: * @filename: an optional file name or URI
! 133: * @enc: an optional encoding
! 134: *
! 135: * Create a parser context for using the DocBook SGML parser in push mode
! 136: * To allow content encoding detection, @size should be >= 4
! 137: * The value of @filename is used for fetching external entities
! 138: * and error/warning reports.
! 139: *
! 140: * Returns the new parser context or NULL
! 141: */
! 142: docbParserCtxtPtr
! 143: docbCreatePushParserCtxt(docbSAXHandlerPtr sax ATTRIBUTE_UNUSED,
! 144: void *user_data ATTRIBUTE_UNUSED,
! 145: const char *chunk ATTRIBUTE_UNUSED,
! 146: int size ATTRIBUTE_UNUSED,
! 147: const char *filename ATTRIBUTE_UNUSED,
! 148: xmlCharEncoding enc ATTRIBUTE_UNUSED)
! 149: {
! 150: static int deprecated = 0;
! 151:
! 152: if (!deprecated) {
! 153: xmlGenericError(xmlGenericErrorContext,
! 154: "docbParseChunk() deprecated function reached\n");
! 155: deprecated = 1;
! 156: }
! 157:
! 158: return(xmlCreatePushParserCtxt(sax, user_data, chunk, size, filename));
! 159: }
! 160:
! 161: /**
! 162: * docbSAXParseDoc:
! 163: * @cur: a pointer to an array of xmlChar
! 164: * @encoding: a free form C string describing the SGML document encoding, or NULL
! 165: * @sax: the SAX handler block
! 166: * @userData: if using SAX, this pointer will be provided on callbacks.
! 167: *
! 168: * parse an SGML in-memory document and build a tree.
! 169: * It use the given SAX function block to handle the parsing callback.
! 170: * If sax is NULL, fallback to the default DOM tree building routines.
! 171: *
! 172: * Returns the resulting document tree
! 173: */
! 174:
! 175: docbDocPtr
! 176: docbSAXParseDoc(xmlChar * cur ATTRIBUTE_UNUSED,
! 177: const char *encoding ATTRIBUTE_UNUSED,
! 178: docbSAXHandlerPtr sax ATTRIBUTE_UNUSED,
! 179: void *userData ATTRIBUTE_UNUSED)
! 180: {
! 181: static int deprecated = 0;
! 182:
! 183: if (!deprecated) {
! 184: xmlGenericError(xmlGenericErrorContext,
! 185: "docbParseChunk() deprecated function reached\n");
! 186: deprecated = 1;
! 187: }
! 188:
! 189: return (xmlSAXParseMemoryWithData(sax, (const char *)cur,
! 190: xmlStrlen((const xmlChar *) cur), 0, userData));
! 191: }
! 192:
! 193: /**
! 194: * docbParseDoc:
! 195: * @cur: a pointer to an array of xmlChar
! 196: * @encoding: a free form C string describing the SGML document encoding, or NULL
! 197: *
! 198: * parse an SGML in-memory document and build a tree.
! 199: *
! 200: * Returns the resulting document tree
! 201: */
! 202:
! 203: docbDocPtr
! 204: docbParseDoc(xmlChar * cur ATTRIBUTE_UNUSED,
! 205: const char *encoding ATTRIBUTE_UNUSED)
! 206: {
! 207: static int deprecated = 0;
! 208:
! 209: if (!deprecated) {
! 210: xmlGenericError(xmlGenericErrorContext,
! 211: "docbParseChunk() deprecated function reached\n");
! 212: deprecated = 1;
! 213: }
! 214:
! 215: return (xmlParseDoc(cur));
! 216: }
! 217:
! 218:
! 219: /**
! 220: * docbCreateFileParserCtxt:
! 221: * @filename: the filename
! 222: * @encoding: the SGML document encoding, or NULL
! 223: *
! 224: * Create a parser context for a file content.
! 225: * Automatic support for ZLIB/Compress compressed document is provided
! 226: * by default if found at compile-time.
! 227: *
! 228: * Returns the new parser context or NULL
! 229: */
! 230: docbParserCtxtPtr
! 231: docbCreateFileParserCtxt(const char *filename ATTRIBUTE_UNUSED,
! 232: const char *encoding ATTRIBUTE_UNUSED)
! 233: {
! 234: static int deprecated = 0;
! 235:
! 236: if (!deprecated) {
! 237: xmlGenericError(xmlGenericErrorContext,
! 238: "docbCreateFileParserCtxt() deprecated function reached\n");
! 239: deprecated = 1;
! 240: }
! 241:
! 242: return (xmlCreateFileParserCtxt(filename));
! 243: }
! 244:
! 245: /**
! 246: * docbSAXParseFile:
! 247: * @filename: the filename
! 248: * @encoding: a free form C string describing the SGML document encoding, or NULL
! 249: * @sax: the SAX handler block
! 250: * @userData: if using SAX, this pointer will be provided on callbacks.
! 251: *
! 252: * parse an SGML file and build a tree. Automatic support for ZLIB/Compress
! 253: * compressed document is provided by default if found at compile-time.
! 254: * It use the given SAX function block to handle the parsing callback.
! 255: * If sax is NULL, fallback to the default DOM tree building routines.
! 256: *
! 257: * Returns the resulting document tree
! 258: */
! 259:
! 260: docbDocPtr
! 261: docbSAXParseFile(const char *filename ATTRIBUTE_UNUSED,
! 262: const char *encoding ATTRIBUTE_UNUSED,
! 263: docbSAXHandlerPtr sax ATTRIBUTE_UNUSED,
! 264: void *userData ATTRIBUTE_UNUSED)
! 265: {
! 266: static int deprecated = 0;
! 267:
! 268: if (!deprecated) {
! 269: xmlGenericError(xmlGenericErrorContext,
! 270: "docbSAXParseFile() deprecated function reached\n");
! 271: deprecated = 1;
! 272: }
! 273:
! 274: return (xmlSAXParseFileWithData(sax, filename, 0, userData));
! 275: }
! 276:
! 277: /**
! 278: * docbParseFile:
! 279: * @filename: the filename
! 280: * @encoding: a free form C string describing document encoding, or NULL
! 281: *
! 282: * parse a Docbook SGML file and build a tree. Automatic support for
! 283: * ZLIB/Compress compressed document is provided by default if found
! 284: * at compile-time.
! 285: *
! 286: * Returns the resulting document tree
! 287: */
! 288:
! 289: docbDocPtr
! 290: docbParseFile(const char *filename ATTRIBUTE_UNUSED,
! 291: const char *encoding ATTRIBUTE_UNUSED)
! 292: {
! 293: static int deprecated = 0;
! 294:
! 295: if (!deprecated) {
! 296: xmlGenericError(xmlGenericErrorContext,
! 297: "docbParseFile() deprecated function reached\n");
! 298: deprecated = 1;
! 299: }
! 300:
! 301: return (xmlParseFile(filename));
! 302: }
! 303: #define bottom_DOCBparser
! 304: #include "elfgcchack.h"
! 305: #endif /* LIBXML_DOCB_ENABLED */
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/cvsweb/back.gif){kind=icon}
Return to DOCBparser.c CVS log ![[TXT]](/icons/cvsweb/text.gif){kind=icon}
![[DIR]](/icons/cvsweb/dir.gif){kind=icon}
Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / libxml2