


tidy(1)                   User commands                   tidy(1)


NAME
       tidy - validate, correct, and pretty-print HTML files
       (version: 1 September 2005)

SYNOPSIS
       tidy [option ...] [file ...] [option ...] [file ...]

DESCRIPTION
       Tidy reads HTML, XHTML and XML files and writes cleaned up markup.  For
       HTML variants, it detects and corrects many common  coding  errors  and
       strives  to produce visually equivalent markup that is both W3C compli-
       ant and works on most browsers. A common use  of  Tidy  is  to  convert
       plain  HTML  to  XHTML.  For generic XML files, Tidy is limited to cor-
       recting basic well-formedness errors and pretty printing.

       If no input file is specified, Tidy reads the standard  input.   If  no
       output file is specified, Tidy writes the tidied markup to the standard
       output.  If no error file is specified, Tidy  writes  messages  to  the
       standard error.  For command line options that expect a numerical argu-
       ment, a default is assumed if no meaningful value can be found.

OPTIONS
   File manipulation
       -output <file>, -o <file>
              write output to the specified <file> (output-file: <file>)

       -config <file>
              set configuration options from the specified <file>


       -file <file>, -f <file>
              write errors to the specified <file> (error-file: <file>)

       -modify, -m
              modify the original input files (write-back: yes)

   Processing directives
       -indent, -i
              indent element content (indent: auto)

       -wrap <column>, -w <column>
              wrap text at the specified <column>. 0 is assumed if <column> is
              missing. When this option is omitted, the default of the config-
              uration option "wrap" applies.  (wrap: <column>)

       -upper, -u
              force tags to upper case (uppercase-tags: yes)

       -clean, -c
              replace FONT, NOBR and CENTER tags by CSS (clean: yes)

       -bare, -b
              strip out smart quotes and em dashes, etc.  (bare: yes)




HTML Tidy 1 Septemb$Date:52005/10/20 17:57:11 $                 1





tidy(1)                   User commands                   tidy(1)


       -numeric, -n
              output numeric rather  than  named  entities  (numeric-entities:
              yes)

       -errors, -e
              only show errors (markup: no)

       -quiet, -q
              suppress nonessential output (quiet: yes)

       -omit  omit optional end tags (hide-endtags: yes)

       -xml   specify the input is well formed XML (input-xml: yes)

       -asxml, -asxhtml
              convert HTML to well formed XHTML (output-xhtml: yes)

       -ashtml
              force XHTML to well formed HTML (output-html: yes)

       -access <level>
              do  additional accessibility checks (<level> = 0, 1, 2, 3). 0 is
              assumed if <level> is missing.  (accessibility-check: <level>)

   Character encodings
       -raw   output values above 127 without conversion to entities


       -ascii use ISO-8859-1 for input, US-ASCII for output


       -latin0
              use ISO-8859-15 for input, US-ASCII for output


       -latin1
              use ISO-8859-1 for both input and output


       -iso2022
              use ISO-2022 for both input and output


       -utf8  use UTF-8 for both input and output


       -mac   use MacRoman for input, US-ASCII for output


       -win1252
              use Windows-1252 for input, US-ASCII for output






HTML Tidy 1 Septemb$Date:52005/10/20 17:57:11 $                 2





tidy(1)                   User commands                   tidy(1)


       -ibm858
              use IBM-858 (CP850+Euro) for input, US-ASCII for output


       -utf16le
              use UTF-16LE for both input and output


       -utf16be
              use UTF-16BE for both input and output


       -utf16 use UTF-16 for both input and output


       -big5  use Big5 for both input and output


       -shiftjis
              use Shift_JIS for both input and output


       -language <lang>
              set the two-letter language code <lang> (for future  use)  (lan-
              guage: <lang>)

   Miscellaneous
       -version, -v
              show the version of Tidy


       -help, -h, -?
              list the command line options


       -xml-help
              list the command line options in XML format


       -help-config
              list all configuration options


       -xml-config
              list all configuration options in XML format


       -show-config
              list the current configuration settings


USAGE
       Use   --optionX  valueX  for  the  any  detailed  configuration  option
       "optionX" with the argument "valueX".  See also  below  under  Detailed



HTML Tidy 1 Septemb$Date:52005/10/20 17:57:11 $                 3





tidy(1)                   User commands                   tidy(1)


       Configuration  Options as to how to conveniently group all such options
       in a single config file.

       Input/Output  default  to  stdin/stdout  respectively.  Single   letter
       options apart from -f and -o may be combined as in:

          tidy -f errs.txt -imu foo.html

       For further info on HTML see http://www.w3.org/MarkUp.

       For  more  information  about HTML Tidy, visit the project home page at
       http://tidy.sourceforge.net.  Here, you will find links  to  documenta-
       tion,  mailing  lists  (with  searchable  archives) and links to report
       bugs.

ENVIRONMENT
       HTML_TIDY
              Name of the default configuration file.  This should be an abso-
              lute  path,  since  you will probably invoke tidy from different
              directories.  The value of HTML_TIDY will be  parsed  after  the
              compiled-in default (defined with -DCONFIG_FILE), but before any
              of the files specified using -config.

EXIT STATUS
       0      All input files were processed successfully.

       1      There were warnings.

       2      There were errors.


______________________________

DETAILED CONFIGURATION OPTIONS
       This section describes the Detailed (i.e., "expanded")  Options,  which
       may  be specified by preceding each option with -- at the command line,
       followed by its desired value, OR by placing the options and values  in
       a configuration file, and telling tidy to read that file with the -con-
       fig standard option.

SYNOPSIS
       tidy --option1 value1 --option2 value2 [standard options ...]
       tidy -config config-file [standard options ...]

WARNING
       The options detailed here do not include  the  "standard"  command-line
       options  (i.e.,  those preceded by a single '-') described above in the
       first section of this man page.

DESCRIPTION
       A list of options for configuring the behavior of Tidy,  which  can  be
       passed  either  on  the  command  line, or specified in a configuration
       file.




HTML Tidy 1 Septemb$Date:52005/10/20 17:57:11 $                 4





tidy(1)                   User commands                   tidy(1)


       A Tidy configuration file is simply a text file, where each  option  is
       listed on a separate line in the form

          option1: value1
          option2: value2
          etc.

       The  permissible values for a given option depend on the option's Type.
       There are five types: Boolean, AutoBool,  DocType,  Enum,  and  String.
       Boolean  types  allow  any of yes/no, y/n, true/false, t/f, 1/0.  Auto-
       Bools allow auto in addition to the values allowed by Booleans.   Inte-
       ger  types  take non-negative integers.  String types generally have no
       defaults, and you should provide them in non-quoted  form  (unless  you
       wish the output to contain the literal quotes).

       Enum,  Encoding,  and DocType "types" have a fixed repertoire of items;
       consult the Example[s] provided below for the option[s] in question.

       You only need to provide options and values for  those  whose  defaults
       you  wish  to  override, although you may wish to include some already-
       defaulted options and values for the sake of documentation and  explic-
       itness.

       Here  is a sample config file, with at least one example of each of the
       five Types:


           // sample Tidy configuration options
           output-xhtml: yes
           add-xml-decl: no
           doctype: strict
           char-encoding: ascii
           indent: auto
           wrap: 76
           repeated-attributes: keep-last
           error-file: errs.txt


       Below is a summary and brief description of each of the  options.  They
       are  listed  alphabetically within each category.  There are five cate-
       gories: HTML, XHTML, XML options,  Diagnostics  options,  Pretty  Print
       options, Character Encoding options, and Miscellaneous options.


OPTIONS
   HTML, XHTML, XML options:
       add-xml-decl

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This  option  specifies  if  Tidy should add the XML declaration
              when outputting XML or XHTML. Note that  if  the  input  already



HTML Tidy 1 Septemb$Date:52005/10/20 17:57:11 $                 5





tidy(1)                   User commands                   tidy(1)


              includes  an  <?xml  ... ?> declaration then this option will be
              ignored. If the  encoding  for  the  output  is  different  from
              "ascii",  one  of the utf encodings or "raw", the declaration is
              always added as required by the XML standard.


                                      See also: char-encoding, output-encoding

       add-xml-space

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should add xml:space="preserve" to
              elements  such  as  <PRE>,  <STYLE> and <SCRIPT> when generating
              XML. This is needed if the whitespace in such elements is to  be
              parsed appropriately without having access to the DTD.

       alt-text

              Type:    String
              Default: -
              Default: -

              This  option  specifies  the  default  "alt=" text Tidy uses for
              <IMG> attributes. This feature is  dangerous  as  it  suppresses
              further  accessibility  warnings. You are responsible for making
              your documents accessible to people who can not see the  images!

       assume-xml-procins

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This  option specifies if Tidy should change the parsing of pro-
              cessing instructions to require ?> as the terminator rather than
              >. This option is automatically set if the input is in XML.

       bare    Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This  option  specifies  if Tidy should strip Microsoft specific
              HTML from Word 2000 documents, and  output  spaces  rather  than
              non-breaking spaces where they exist in the input.

       clean   Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should strip out surplus presenta-
              tional tags and attributes replacing them  by  style  rules  and



HTML Tidy 1 Septemb$Date:52005/10/20 17:57:11 $                 6





tidy(1)                   User commands                   tidy(1)


              structural  markup  as  appropriate.  It  works well on the HTML
              saved by Microsoft Office products.

       css-prefix

              Type:    String
              Default: -
              Default: -

              This option specifies the  prefix  that  Tidy  uses  for  styles
              rules. By default, "c" will be used.

       doctype

              Type:    DocType
              Default: auto
              Example: omit, auto, strict, transitional, user

              This option specifies the DOCTYPE declaration generated by Tidy.
              If set to "omit" the output won't contain a DOCTYPE declaration.
              If  set  to "auto" (the default) Tidy will use an educated guess
              based upon the contents of the document.  If  set  to  "strict",
              Tidy  will set the DOCTYPE to the strict DTD. If set to "loose",
              the DOCTYPE is set to the  loose  (transitional)  DTD.  Alterna-
              tively, you can supply a string for the formal public identifier
              (FPI).

              For example:
              doctype: "-//ACME//DTD HTML 3.14159//EN"

              If you specify the FPI for an XHTML document, Tidy will set  the
              system  identifier  to  the  empty string. For an HTML document,
              Tidy adds a system identifier only if one was already present in
              order  to  preserve  the  processing mode of some browsers. Tidy
              leaves the DOCTYPE for generic XML documents  unchanged.  --doc-
              type omit implies --numeric-entities yes.

       drop-empty-paras

              Type:    Boolean
              Default: yes
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should discard empty paragraphs.

       drop-font-tags

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should discard <FONT> and <CENTER>
              tags without creating the corresponding style rules. This option
              can be set independently of the clean option.



HTML Tidy 1 Septemb$Date:52005/10/20 17:57:11 $                 7





tidy(1)                   User commands                   tidy(1)


       drop-proprietary-attributes

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This  option  specifies  if  Tidy  should  strip out proprietary
              attributes, such as MS data binding attributes.

       enclose-block-text

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should insert  a  <P>  element  to
              enclose  any text it finds in any element that allows mixed con-
              tent for HTML transitional but not HTML strict.

       enclose-text

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should enclose any text  it  finds
              in  the  body  element within a <P> element. This is useful when
              you want to take existing HTML and use it with a style sheet.

       escape-cdata

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should convert  <![CDATA[]]>  sec-
              tions to normal text.

       fix-backslash

              Type:    Boolean
              Default: yes
              Example: y/n, yes/no, t/f, true/false, 1/0

              This  option  specifies if Tidy should replace backslash charac-
              ters "\" in URLs by forward slashes "/".

       fix-bad-comments

              Type:    Boolean
              Default: yes
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should replace unexpected  hyphens



HTML Tidy 1 Septemb$Date:52005/10/20 17:57:11 $                 8





tidy(1)                   User commands                   tidy(1)


              with  "="  characters when it comes across adjacent hyphens. The
              default is yes. This option is provided for users of Cold Fusion
              which uses the comment syntax: <!--- --->

       fix-uri

              Type:    Boolean
              Default: yes
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should check attribute values that
              carry URIs for illegal characters and if such are found,  escape
              them as HTML 4 recommends.

       hide-comments

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should print out comments.

       hide-endtags

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should omit optional end-tags when
              generating the pretty printed markup. This option is ignored  if
              you are outputting to XML.

       indent-cdata

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This  option  specifies  if Tidy should indent <![CDATA[]]> sec-
              tions.

       input-xml

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should use the XML  parser  rather
              than the error correcting HTML parser.

       join-classes

              Type:    Boolean
              Default: no



HTML Tidy 1 Septemb$Date:52005/10/20 17:57:11 $                 9





tidy(1)                   User commands                   tidy(1)


              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should combine class names to gen-
              erate a single new class name, if multiple class assignments are
              detected on an element.


                                    See also: join-styles, repeated-attributes

       join-styles

              Type:    Boolean
              Default: yes
              Example: y/n, yes/no, t/f, true/false, 1/0

              This  option specifies if Tidy should combine styles to generate
              a single new style, if multiple style values are detected on  an
              element.


                                   See also: join-classes, repeated-attributes

       literal-attributes

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This  option  specifies  if  Tidy  should ensure that whitespace
              characters within attribute values are passed through unchanged.

       logical-emphasis

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This  option  specifies if Tidy should replace any occurrence of
              <I> by <EM> and any occurrence  of  <B>  by  <STRONG>.  In  both
              cases,  the  attributes are preserved unchanged. This option can
              be set independently of the clean and drop-font-tags options.

       lower-literals

              Type:    Boolean
              Default: yes
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should convert  the  value  of  an
              attribute  that takes a list of predefined values to lower case.
              This is required for XHTML documents.

       merge-divs




HTML Tidy 1 Septemb$Date:52005/10/20 17:57:11 $                10





tidy(1)                   User commands                   tidy(1)


              Type:    AutoBool
              Default: auto
              Example: auto, y/n, yes/no, t/f, true/false, 1/0

              Can be used to modify behavior of -c (--clean yes) option.  This
              option  specifies  if  Tidy  should  merge  nested <div> such as
              "<div><div>...</div></div>". If set to "auto", the attributes of
              the  inner  <div>  are  moved  to the outer one. As well, nested
              <div> with ID attributes are not merged. If set  to  "yes",  the
              attributes  of  the inner <div> are discarded with the exception
              of "class" and "style".


                                                               See also: clean

       ncr     Type:    Boolean
              Default: yes
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy  should  allow  numeric  character
              references.

       new-blocklevel-tags

              Type:    Tag names
              Default: -
              Example: tagX, tagY, ...

              This  option specifies new block-level tags. This option takes a
              space or comma separated list of tag names. Unless  you  declare
              new  tags,  Tidy  will  refuse  to generate a tidied file if the
              input includes previously unknown tags. Note  you  can't  change
              the  content  model for elements such as <TABLE>, <UL>, <OL> and
              <DL>.


                       See also: new-empty-tags, new-inline-tags, new-pre-tags

       new-empty-tags

              Type:    Tag names
              Default: -
              Example: tagX, tagY, ...

              This option specifies new empty inline tags. This option takes a
              space  or  comma separated list of tag names. Unless you declare
              new tags, Tidy will refuse to generate  a  tidied  file  if  the
              input includes previously unknown tags. Remember to also declare
              empty tags as either inline or blocklevel.


                  See also: new-blocklevel-tags, new-inline-tags, new-pre-tags





HTML Tidy 1 Septemb$Date:52005/10/20 17:57:11 $                11





tidy(1)                   User commands                   tidy(1)


       new-inline-tags

              Type:    Tag names
              Default: -
              Example: tagX, tagY, ...

              This option specifies new non-empty  inline  tags.  This  option
              takes  a  space or comma separated list of tag names. Unless you
              declare new tags, Tidy will refuse to generate a tidied file  if
              the input includes previously unknown tags.


                   See also: new-blocklevel-tags, new-empty-tags, new-pre-tags

       new-pre-tags

              Type:    Tag names
              Default: -
              Example: tagX, tagY, ...

              This  option  specifies  new  tags  that  are to be processed in
              exactly the same way as HTML's <PRE> element. This option  takes
              a space or comma separated list of tag names. Unless you declare
              new tags, Tidy will refuse to generate  a  tidied  file  if  the
              input  includes previously unknown tags. Note you can not as yet
              add new CDATA elements (similar to <SCRIPT>).


                See also: new-blocklevel-tags, new-empty-tags, new-inline-tags

       numeric-entities

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should output entities other  than
              the built-in HTML entities (&amp;, &lt;, &gt; and &quot;) in the
              numeric rather than the named entity form.


                                                             See also: doctype

       output-html

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy  should  generate  pretty  printed
              output, writing it as HTML.

       output-xhtml




HTML Tidy 1 Septemb$Date:52005/10/20 17:57:11 $                12





tidy(1)                   User commands                   tidy(1)


              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This  option  specifies  if  Tidy should generate pretty printed
              output, writing it as extensible HTML. This option  causes  Tidy
              to  set  the  DOCTYPE  and  default  namespace as appropriate to
              XHTML. If a DOCTYPE or namespace is given they will checked  for
              consistency  with the content of the document. In the case of an
              inconsistency, the corrected values will appear in  the  output.
              For  XHTML, entities can be written as named or numeric entities
              according to the setting of the "numeric-entities"  option.  The
              original  case of tags and attributes will be preserved, regard-
              less of other options.

       output-xml

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should pretty print output,  writ-
              ing  it  as well-formed XML. Any entities not defined in XML 1.0
              will be written as numeric entities to allow them to  be  parsed
              by  a  XML parser. The original case of tags and attributes will
              be preserved, regardless of other options.

       quote-ampersand

              Type:    Boolean
              Default: yes
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should output unadorned &  charac-
              ters as &amp;.

       quote-marks

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This  option  specifies  if  Tidy  should output " characters as
              &quot; as is preferred by some editing environments.  The  apos-
              trophe  character  '  is  written  out  as  &#39; since many web
              browsers don't yet support &apos;.

       quote-nbsp

              Type:    Boolean
              Default: yes
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should output  non-breaking  space



HTML Tidy 1 Septemb$Date:52005/10/20 17:57:11 $                13





tidy(1)                   User commands                   tidy(1)


              characters  as  entities,  rather  than as the Unicode character
              value 160 (decimal).

       repeated-attributes

              Type:    enum
              Default: keep-last
              Example: keep-first, keep-last

              This option specifies if Tidy should  keep  the  first  or  last
              attribute,  if  an  attribute  is  repeated,  e.g. has two align
              attributes.


                                           See also: join-classes, join-styles

       replace-color

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should replace numeric  values  in
              color  attributes  by HTML/XHTML color names where defined, e.g.
              replace "#ffffff" with "white".

       show-body-only

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should print only the contents  of
              the  body  tag  as  an  HTML  fragment. Useful for incorporating
              existing whole pages as a portion of another page.

       uppercase-attributes

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should output attribute  names  in
              upper  case.  The  default  is  no,  which results in lower case
              attribute names, except for XML input, where the  original  case
              is preserved.

       uppercase-tags

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This  option  specifies if Tidy should output tag names in upper



HTML Tidy 1 Septemb$Date:52005/10/20 17:57:11 $                14





tidy(1)                   User commands                   tidy(1)


              case. The default is no, which results in lower case tag  names,
              except for XML input, where the original case is preserved.

       word-2000

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This  option specifies if Tidy should go to great pains to strip
              out all the surplus stuff Microsoft Word 2000 inserts  when  you
              save  Word  documents  as  "Web  pages". Doesn't handle embedded
              images or VML. You should consider using Word's  "Save  As:  Web
              Page, Filtered".

   Diagnostics options:
       accessibility-check

              Type:    enum
              Default: 0 (Tidy Classic)
              Example:  0 (Tidy Classic), 1 (Priority 1 Checks), 2 (Priority 2
              Checks), 3 (Priority 3 Checks)

              This option specifies what level of accessibility  checking,  if
              any,  that  Tidy  should do. Level 0 is equivalent to Tidy Clas-
              sic's accessibility checking. For  more  information  on  Tidy's
              accessibility  checking,  visit the Adaptive Technology Resource
              Centre     at     the     University     of      Toronto      at
              http://www.aprompt.ca/Tidy/accessibilitychecks.html.

       show-errors

              Type:    Integer
              Default: 6
              Example: 0, 1, 2, ...

              This  option specifies the number Tidy uses to determine if fur-
              ther errors should be shown. If set to 0,  then  no  errors  are
              shown.

       show-warnings

              Type:    Boolean
              Default: yes
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should suppress warnings. This can
              be useful when a few errors are hidden in a flurry of  warnings.

   Pretty Print options:
       break-before-br

              Type:    Boolean
              Default: no



HTML Tidy 1 Septemb$Date:52005/10/20 17:57:11 $                15





tidy(1)                   User commands                   tidy(1)


              Example: y/n, yes/no, t/f, true/false, 1/0

              This  option specifies if Tidy should output a line break before
              each <BR> element.

       indent  Type:    AutoBool
              Default: no
              Example: auto, y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should indent block-level tags. If
              set  to "auto", this option causes Tidy to decide whether or not
              to indent the content of tags such as TITLE, H1-H6, LI, TD,  TD,
              or  P  depending on whether or not the content includes a block-
              level element. You are advised to avoid setting indent to yes as
              this can expose layout bugs in some browsers.


                                                       See also: indent-spaces

       indent-attributes

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This  option  specifies if Tidy should begin each attribute on a
              new line.

       indent-spaces

              Type:    Integer
              Default: 2
              Example: 0, 1, 2, ...

              This option specifies the number of spaces Tidy uses  to  indent
              content, when indentation is enabled.


                                                              See also: indent

       markup  Type:    Boolean
              Default: yes
              Example: y/n, yes/no, t/f, true/false, 1/0

              This  option  specifies if Tidy should generate a pretty printed
              version of the markup. Note that Tidy won't  generate  a  pretty
              printed  version  if it finds significant errors (see force-out-
              put).

       punctuation-wrap

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0



HTML Tidy 1 Septemb$Date:52005/10/20 17:57:11 $                16





tidy(1)                   User commands                   tidy(1)


              This option specifies if Tidy should line wrap after  some  Uni-
              code or Chinese punctuation characters.

       split   Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              Currently not used. Tidy Classic only.

       tab-size

              Type:    Integer
              Default: 8
              Example: 0, 1, 2, ...

              This  option  specifies  the  number  of  columns that Tidy uses
              between successive tab stops. It is used to map tabs  to  spaces
              when reading the input. Tidy never outputs tabs.

       vertical-space

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This  option  specifies  if Tidy should add some empty lines for
              readability.

       wrap    Type:    Integer
              Default: 68
              Example: 0 (no wrapping), 1, 2, ...

              This option specifies the right margin Tidy uses for line  wrap-
              ping.  Tidy  tries to wrap lines so that they do not exceed this
              length. Set wrap to zero if you want to disable line wrapping.

       wrap-asp

              Type:    Boolean
              Default: yes
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should line  wrap  text  contained
              within ASP pseudo elements, which look like: <% ... %>.

       wrap-attributes

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should line wrap attribute values,
              for easier editing. This option  can  be  set  independently  of
              wrap-script-literals.



HTML Tidy 1 Septemb$Date:52005/10/20 17:57:11 $                17





tidy(1)                   User commands                   tidy(1)


                                                See also: wrap-script-literals

       wrap-jste

              Type:    Boolean
              Default: yes
              Example: y/n, yes/no, t/f, true/false, 1/0

              This  option  specifies  if Tidy should line wrap text contained
              within JSTE pseudo elements, which look like: <# ... #>.

       wrap-php

              Type:    Boolean
              Default: yes
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should line  wrap  text  contained
              within PHP pseudo elements, which look like: <?php ... ?>.

       wrap-script-literals

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This  option  specifies if Tidy should line wrap string literals
              that appear in script attributes. Tidy wraps long script  string
              literals  by  inserting  a  backslash  character before the line
              break.


                                                     See also: wrap-attributes

       wrap-sections

              Type:    Boolean
              Default: yes
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should line  wrap  text  contained
              within <![ ... ]> section tags.

   Character Encoding options:
       ascii-chars

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              Can  be  used  to modify behavior of -c (--clean yes) option. If
              set to "yes" when using -c, &emdash;, &rdquo;, and  other  named
              character entities are downgraded to their closest ascii equiva-
              lents.



HTML Tidy 1 Septemb$Date:52005/10/20 17:57:11 $                18





tidy(1)                   User commands                   tidy(1)


                                                               See also: clean

       char-encoding

              Type:    Encoding
              Default: ascii
              Example:  raw,  ascii,  latin0,  latin1,  utf8,  iso2022,   mac,
              win1252, ibm858, utf16le, utf16be, utf16, big5, shiftjis

              This  option specifies the character encoding Tidy uses for both
              the input and  output.  For  ascii,  Tidy  will  accept  Latin-1
              (ISO-8859-1)  character  values,  but  will use entities for all
              characters whose value > 127. For raw, Tidy will  output  values
              above  127  without  translating them into entities. For latin1,
              characters above 255 will be written as entities. For utf8, Tidy
              assumes  that both input and output is encoded as UTF-8. You can
              use iso2022 for files  encoded  using  the  ISO-2022  family  of
              encodings  e.g.  ISO-2022-JP.  For  mac  and  win1252, Tidy will
              accept vendor specific character values, but will  use  entities
              for all characters whose value > 127.


                                     See also: input-encoding, output-encoding

       input-encoding

              Type:    Encoding
              Default: latin1
              Example:   raw,  ascii,  latin0,  latin1,  utf8,  iso2022,  mac,
              win1252, ibm858, utf16le, utf16be, utf16, big5, shiftjis

              This option specifies the character encoding Tidy uses  for  the
              input. See char-encoding for more info.


                                                       See also: char-encoding

       language

              Type:    String
              Default: -
              Default: -

              Currently  not used, but this option specifies the language Tidy
              uses (for instance "en").

       newline

              Type:    enum
              Default: Platform dependent
              Example: LF, CRLF, CR

              The default is appropriate to the current platform: CRLF on  PC-
              DOS,  MS-Windows  and  OS/2,  CR  on  Classic  Mac  OS,  and  LF



HTML Tidy 1 Septemb$Date:52005/10/20 17:57:11 $                19





tidy(1)                   User commands                   tidy(1)


              everywhere else (Unix and Linux).

       output-bom

              Type:    AutoBool
              Default: auto
              Example: auto, y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should write a Unicode Byte  Order
              Mark  character  (BOM;  also known as Zero Width No-Break Space;
              has value of U+FEFF) to the beginning of the  output;  only  for
              UTF-8 and UTF-16 output encodings. If set to "auto", this option
              causes Tidy to write a BOM to the output only if a BOM was  pre-
              sent  at the beginning of the input. A BOM is always written for
              XML/XHTML output using UTF-16 output encodings.

       output-encoding

              Type:    Encoding
              Default: ascii
              Example:  raw,  ascii,  latin0,  latin1,  utf8,  iso2022,   mac,
              win1252, ibm858, utf16le, utf16be, utf16, big5, shiftjis

              This  option  specifies the character encoding Tidy uses for the
              output. See char-encoding for more info. May only  be  different
              from  input-encoding for Latin encodings (ascii, latin0, latin1,
              mac, win1252, ibm858).


                                                       See also: char-encoding

   Miscellaneous options:
       error-file

              Type:    String
              Default: -
              Default: -

              This option specifies the error file Tidy uses  for  errors  and
              warnings. Normally errors and warnings are output to "stderr".


                                                         See also: output-file

       force-output

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This  option  specifies  if  Tidy  should produce output even if
              errors are encountered. Use this option  with  care  -  if  Tidy
              reports  an  error,  this  means Tidy was not able to, or is not
              sure how to, fix the error, so  the  resulting  output  may  not



HTML Tidy 1 Septemb$Date:52005/10/20 17:57:11 $                20





tidy(1)                   User commands                   tidy(1)


              reflect your intention.

       gnu-emacs

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This  option  specifies  if  Tidy  should  change the format for
              reporting errors and warnings to a format that  is  more  easily
              parsed by GNU Emacs.

       gnu-emacs-file

              Type:    String
              Default: -
              Default: -

              Used internally.

       keep-time

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This option specifies if Tidy should keep the original modifica-
              tion time of files that Tidy modifies in place. The  default  is
              no.  Setting  the option to yes allows you to tidy files without
              causing these files to be uploaded to a web server when using  a
              tool  such  as  SiteCopy.  Note this feature is not supported on
              some platforms.

       output-file

              Type:    String
              Default: -
              Default: -

              This option specifies the output file Tidy uses for markup. Nor-
              mally markup is written to "stdout".


                                                          See also: error-file

       quiet   Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This  option  specifies if Tidy should output the summary of the
              numbers of errors and warnings, or the welcome or  informational
              messages.





HTML Tidy 1 Septemb$Date:52005/10/20 17:57:11 $                21





tidy(1)                   User commands                   tidy(1)


       slide-style

              Type:    String
              Default: -
              Default: -

              Currently not used. Tidy Classic only.

       tidy-mark

              Type:    Boolean
              Default: yes
              Example: y/n, yes/no, t/f, true/false, 1/0

              This  option  specifies if Tidy should add a meta element to the
              document head to indicate that the  document  has  been  tidied.
              Tidy won't add a meta element if one is already present.

       write-back

              Type:    Boolean
              Default: no
              Example: y/n, yes/no, t/f, true/false, 1/0

              This  option  specifies  if  Tidy  should  write back the tidied
              markup to the same file it read from. You are  advised  to  keep
              copies  of important files before tidying them, as on rare occa-
              sions the result may not be what you expect.

SEE ALSO
       HTML Tidy Project Page at http://tidy.sourceforge.net

AUTHOR
       Tidy was written by Dave Raggett <dsr@w3.org>, and  is  now  maintained
       and  developed by the Tidy team at http://tidy.sourceforge.net/.  It is
       released under the MIT Licence.

       Generated automatically with HTML Tidy released on 1 September 2005.



















HTML Tidy 1 Septemb$Date:52005/10/20 17:57:11 $                22


