Welcome to Linux Knowledge Base and Tutorial
"The place where you learn linux"

 Create an AccountHome | Submit News | Your Account  

Tutorial Menu
Linux Tutorial Home
Table of Contents

· Introduction to Operating Systems
· Linux Basics
· Working with the System
· Shells and Utilities
· Editing Files
· Basic Administration
· The Operating System
· The X Windowing System
· The Computer Itself
· Networking
· System Monitoring
· Solving Problems
· Security
· Installing and Upgrading
· Linux and Windows

Glossary
MoreInfo
Man Pages
Linux Topics
Test Your Knowledge

Site Menu
Site Map
FAQ
Copyright Info
Terms of Use
Privacy Info
Disclaimer
WorkBoard
Thanks
Donations
Advertising
Masthead / Impressum
Your Account

Communication
Feedback
Forums
Private Messages
Surveys

Features
HOWTOs
News Archive
Submit News
Topics
User Articles
Web Links

Google
Google


The Web
linux-tutorial.info

Who's Online
There are currently, 166 guest(s) and 0 member(s) that are online.

You are an Anonymous user. You can register for free by clicking here

  

xmlwf



SYNOPSIS

       xmlwf [ -s]  [ -n]  [ -p]  [ -x]  [ -e encoding]  [ -w]  [
       -d output-dir]  [ -c]  [ -m]  [ -r]  [ -t]  [ -v]  [  file
       ...]


DESCRIPTION

       xmlwf  uses the Expat library to determine if an XML docu­
       ment is well-formed.  It is non-validating.

       If you do not specify any files on the  command-line,  and
       you have a recent version of xmlwf, the input file will be
       read from standard input.


WELL-FORMED DOCUMENTS

       A well-formed document must adhere to the following rules:

       · The  file begins with an XML declaration.  For instance,
         <?xml  version="1.0"  standalone="yes"?>.   NOTE:  xmlwf
         does not currently check for a valid XML declaration.

       · Every start tag is either empty (<tag/>) or has a corre­
         sponding end tag.

       · There is exactly one root element.   This  element  must
         contain  all  other elements in the document.  Only com­
         ments, white space, and processing instructions may come
         after the close of the root element.

       · All elements nest properly.

       · All attribute values are enclosed in quotes (either sin­
         gle or double).

       If the document has a DTD, and it strictly  complies  with
       that  DTD,  then  the  document  is also considered valid.
       xmlwf is a non-validating parser -- it does not check  the
       DTD.   However, it does support external entities (see the
       -x option).


OPTIONS

       When an option includes an argument, you may  specify  the
       argument  either  separately ("-d output") or concatenated
       with the option ("-doutput").  xmlwf supports both.

       -c     If the input file is well-formed and xmlwf  doesn't
              encounter  any  errors,  the  input  file is simply
              copied to the  output  directory  unchanged.   This
              implies  no  namespaces (turns off -n) and requires
              -d to specify an output file.

       -d output-dir

              Two  structurally  equivalent  XML documents have a
              byte-for-byte identical canonical  XML  representa­
              tion.   Note  that ignorable white space is consid­
              ered significant and  is  treated  equivalently  to
              data.   More  on  canonical  XML  can  be  found at
              http://www.jclark.com/xml/canonxml.html .

       -e encoding
              Specifies the character encoding for the  document,
              overriding   any   document  encoding  declaration.
              xmlwf supports four built-in  encodings:  US-ASCII,
              UTF-8,  UTF-16,  and  ISO-8859-1.   Also see the -w
              option.

       -m     Outputs some strange sort of  XML  file  that  com­
              pletely  describes  the  the  input file, including
              character postitions.  Requires -d  to  specify  an
              output file.

       -n     Turns  on  namespace  processing.  (describe names­
              paces) -c disables namespaces.

       -p     Tells xmlwf to process external DTDs and  parameter
              entities.

              Normally xmlwf never parses parameter entities.  -p
              tells it to always parse them.  -p implies -x.

       -r     Normally xmlwf  memory-maps  the  XML  file  before
              parsing;  this can result in faster parsing on many
              platforms.  -r turns off  memory-mapping  and  uses
              normal  file  IO calls instead.  Of course, memory-
              mapping is automatically turned  off  when  reading
              from standard input.

              Use  of  memory-mapping can cause some platforms to
              report substantially higher memory usage for xmlwf,
              but  this  appears  to be a matter of the operating
              system reporting memory in a strange way; there  is
              not a leak in xmlwf.

       -s     Prints  an error if the document is not standalone.
              A document is standalone if it has no external sub­
              set and no references to parameter entities.

       -t     Turns  on  timings.   This tells Expat to parse the
              entire file, but not perform any processing.   This
              gives  a  fairly  accurate idea of the raw speed of
              Expat itself without client overhead.  -t turns off
              most of the output options (-d, -m, -c, ...).

              Expat  always  expands  internal  entities (?), but
              external entity parsing must be enabled explicitly.

              External  entities  are simply entities that obtain
              their data from  outside  the  XML  file  currently
              being parsed.

              This is an example of an internal entity:

              <!ENTITY vers '1.0.2'>

              And here are some examples of external entities:

              <!ENTITY header SYSTEM "header-&vers;.xml">  (parsed)
              <!ENTITY logo SYSTEM "logo.png" PNG>         (unparsed)

       --     (Two  hyphens.)   Terminates  the  list of options.
              This is only needed if a  filename  starts  with  a
              hyphen.  For example:

              xmlwf -- -myfile.xml

              will run xmlwf on the file -myfile.xml.

       Older  versions of xmlwf do not support reading from stan­
       dard input.


OUTPUT

       If an input file is not well-formed, xmlwf prints a single
       line describing the problem to standard output.  If a file
       is well formed, xmlwf  outputs  nothing.   Note  that  the
       result code is not set.


BUGS

       According  to the W3C standard, an XML file without a dec­
       laration at the beginning is not  considered  well-formed.
       However, xmlwf allows this to pass.

       xmlwf  returns a 0 - noerr result, even if the file is not
       well-formed.  There is no good way for a  program  to  use
       xmlwf  to  quickly  check  a file -- it must parse xmlwf's
       standard output.

       The errors should go to standard error, not standard  out­
       put.

       There  should  be  a  way  to get -d to send its output to
       standard output rather than forcing the user to send it to
       a file.

       I  have  no  idea why anyone would want to use the -d, -c,
       and -m options.  If someone could explain it  to  me,  I'd


AUTHOR

       This  manual  page  was  written  by  Scott Bronson <bron­
       son@rinspin.com> for the Debian GNU/Linux system (but  may
       be  used  by others).  Permission is granted to copy, dis­
       tribute and/or modify this document under the terms of the
       GNU Free Documentation License, Version 1.1.

                         24 January 2003                 XMLWF(1)
  
Help us cut cost by not downloading the whole site!
Use of automated download sofware ("harvesters") such as wget, httrack, etc. causes the site to quickly exceed its bandwidth limitation and therefore is expressedly prohibited. For more details on this, take a look here

Login
Nickname

Password

Security Code
Security Code
Type Security Code


Don't have an account yet? You can create one. As a registered user you have some advantages like theme manager, comments configuration and post comments with your name.

Help if you can!


Amazon Wish List

Did You Know?
The Linux Tutorial welcomes your suggestions and ideas.


Friends



Tell a Friend About Us

Bookmark and Share



Web site powered by PHP-Nuke

Is this information useful? At the very least you can help by spreading the word to your favorite newsgroups, mailing lists and forums.
All logos and trademarks in this site are property of their respective owner. The comments are property of their posters. Articles are the property of their respective owners. Unless otherwise stated in the body of the article, article content (C) 1994-2013 by James Mohr. All rights reserved. The stylized page/paper, as well as the terms "The Linux Tutorial", "The Linux Server Tutorial", "The Linux Knowledge Base and Tutorial" and "The place where you learn Linux" are service marks of James Mohr. All rights reserved.
The Linux Knowledge Base and Tutorial may contain links to sites on the Internet, which are owned and operated by third parties. The Linux Tutorial is not responsible for the content of any such third-party site. By viewing/utilizing this web site, you have agreed to our disclaimer, terms of use and privacy policy. Use of automated download software ("harvesters") such as wget, httrack, etc. causes the site to quickly exceed its bandwidth limitation and are therefore expressly prohibited. For more details on this, take a look here

PHP-Nuke Copyright © 2004 by Francisco Burzi. This is free software, and you may redistribute it under the GPL. PHP-Nuke comes with absolutely no warranty, for details, see the license.
Page Generation: 0.04 Seconds