~ubuntu-branches/ubuntu/maverick/universalindentgui/maverick-proposed

« back to all changes in this revision

Viewing changes to indenters/hindent.html

  • Committer: Bazaar Package Importer
  • Author(s): Fathi Boudra
  • Date: 2009-04-29 10:50:58 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20090429105058-7xj26rwxxnir1tr7
Tags: 1.0.2-1
* New upstream release:
  - The default editor font type is now Monospace instead of Courier.
    (Closes: #483873)
* Add 01_disable_check_for_update.diff patch:
  Automatic check for update is disabled by default. (Closes: #514999)
* Bump debian/compat to 7.
* Update debian/control:
  - Set Thomas Schweitzer as maintainer and myself as uploader.
    (Closes: #483068)
  - Bump debhelper build-dependency to 7.
  - Bump Standards-Version to 3.8.1. No changes needed.
  - Update recommended beautifier list.
  - Update description to list all supported beautifiers.
* Update debian/copyright:
  - Add PerlTidy.pm and JsDecoder.js missing copyrights.
* Cleanup debian/rules.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!-- manual page source format generated by PolyglotMan v3.2, -->
 
2
<!-- available at http://polyglotman.sourceforge.net/ -->
 
3
 
 
4
<html>
 
5
<head>
 
6
<title>HINDENT(1) manual page</title>
 
7
</head>
 
8
<body bgcolor='white'>
 
9
<a href='#toc'>Table of Contents</a><p>
 
10
 
 
11
<h2><a name='sect0' href='#toc0'>Name</a></h2>
 
12
hindent - HTML reformatting/nesting utility 
 
13
<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
 
14
<b>hindent</b> [-fslcv]
 
15
[-i <i>num</i>] [-t <i>num</i>] [file ...] 
 
16
<h2><a name='sect2' href='#toc2'>Description</a></h2>
 
17
This utility takes one or more HTML
 
18
files and reformats them by properly indenting them for greater human readability.
 
19
The new HTML code is written to standard output, any errors go to standard
 
20
error. If no file is specified, <b>hindent</b> reads from standard input. If more
 
21
than one file is specified, each is taken in turn and all output is concatenated
 
22
(with no way to distinguish when one output ends and the next begins). <p>
 
23
Without
 
24
any options, <b>hindent</b> simply varies the amount of whitespace at the beginning
 
25
of each line of input - no lines are added or subtracted from the HTML code.
 
26
This means that it generates output that should draw the same on all browsers
 
27
as the input HTML. If the <b>-s</b> or <b>-f</b> options are used, the resulting HTML may
 
28
not draw exactly the same any more.  It is important that you keep your
 
29
original HTML data around, just in case! <p>
 
30
This version of <b>hindent</b> understands
 
31
all container tags defined in the HTML 3.2 standard. 
 
32
<h2><a name='sect3' href='#toc3'>Options</a></h2>
 
33
 
 
34
<dl>
 
35
 
 
36
<dt><b>-c</b> </dt>
 
37
<dd>Case.  Forces
 
38
all tags to lowercase.  By default, <b>hindent</b> forces all tags to uppercase.
 
39
</dd>
 
40
 
 
41
<dt><b>-f</b> </dt>
 
42
<dd>Flow.  Prints just tags without any data between the tags. Damages the
 
43
HTML in a big way, so save a copy of your original HTML. This option helps
 
44
you follow the HTML code flow visually. </dd>
 
45
 
 
46
<dt><b>-i <i>num</i></b> </dt>
 
47
<dd>Indent level.  Set indentation
 
48
to this many character spaces per code nesting level. If set to 0, no indentation
 
49
is done (all output is left-justified). </dd>
 
50
 
 
51
<dt><b>-l</b> </dt>
 
52
<dd>List tags.  Causes <b>hindent</b> to print
 
53
a complete list of tags that it recognizes to stdout, and exits. </dd>
 
54
 
 
55
<dt><b>-s</b> </dt>
 
56
<dd>Strict.
 
57
 Multiple tags per line are broken out onto separate lines. Can damage the
 
58
HTML in minor ways by drawing an extra space character in certain parts
 
59
of the web page, so save a copy of your original HTML. This option helps
 
60
you follow the HTML code flow visually, especially with computer-generated
 
61
HTML that comes out all on one line. </dd>
 
62
 
 
63
<dt><b>-t <i>num</i></b> </dt>
 
64
<dd>Tab stop.  Set the number of spaces
 
65
that a tab character occupies on your system.  Defaults to 8, but some people
 
66
prefer expanding tabs to 4 spaces instead.  If set to 0, no tabs are output
 
67
(spaces used to indent lines). </dd>
 
68
 
 
69
<dt><b>-v</b> </dt>
 
70
<dd>Version.  Prints <b>hindent</b>&rsquo;s version number
 
71
to stdout and exits immediately. </dd>
 
72
</dl>
 
73
<p>
 
74
The <b>-s</b> option is the most useful, it would
 
75
be the default if it didn&rsquo;t damage the HTML code. <p>
 
76
Any combination of these
 
77
options may be used. 
 
78
<p> 
 
79
<h2><a name='sect4' href='#toc4'>Examples</a></h2>
 
80
<p>
 
81
Example 1.  Download a web page, reformat it,
 
82
view it: <br>
 
83
<pre>
 
84
</pre><p>
 
85
 
 
86
<dl>
 
87
 
 
88
<dt>CRlynx -source <a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'>http://www.domtools.com/~pab</a>
 
89
</a>
 
90
</a>
 
91
</a>
 
92
</a>
 
93
</a>
 
94
</a>
 
95
</a>
 
96
</a>
 
97
</a>
 
98
 | hindent | moreExample 2.  View
 
99
only the structure, one tag per line: </dt>
 
100
<dd><br>
 
101
<pre>
 
102
</pre></dd>
 
103
</dl>
 
104
<p>
 
105
 
 
106
<dl>
 
107
 
 
108
<dt>CRlynx -source <a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'><a href='http://www.domtools.com/~pab'>http://www.domtools.com/~pab</a>
 
109
</a>
 
110
</a>
 
111
</a>
 
112
</a>
 
113
</a>
 
114
</a>
 
115
</a>
 
116
</a>
 
117
</a>
 
118
 | hindent -s -f | moreExample 3.  Reformat
 
119
my home page non-damagingly with 4-space tabs, keeping a backup copy: </dt>
 
120
<dd><br>
 
121
<pre>
 
122
 
 
123
 
 
124
</pre></dd>
 
125
</dl>
 
126
 
 
127
<h2><a name='sect5' href='#toc5'>CRcd $HOME/public_htmlmv index.html index.html.oldhindent -i4 index.html.old
 
128
&gt; index.htmlSite</a></h2>
 
129
The master web page for this tool is: 
 
130
<dl>
 
131
 
 
132
<dt><a href='http://www.domtools.com/unix/hindent.shtml'>http://www.domtools.com/unix/hindent.shtml</a>
 
133
 
 
134
</dt>
 
135
<dd></dd>
 
136
</dl>
 
137
 
 
138
<h2><a name='sect6' href='#toc6'>Version</a></h2>
 
139
<b>Hindent</b> version 1.1.2 
 
140
<h2><a name='sect7' href='#toc7'>Author</a></h2>
 
141
Paul Balyoz &lt;pab@domtools.com&gt; <p>
 
142
 
 
143
<hr><p>
 
144
<a name='toc'><b>Table of Contents</b></a><p>
 
145
<ul>
 
146
<li><a name='toc0' href='#sect0'>Name</a></li>
 
147
<li><a name='toc1' href='#sect1'>Synopsis</a></li>
 
148
<li><a name='toc2' href='#sect2'>Description</a></li>
 
149
<li><a name='toc3' href='#sect3'>Options</a></li>
 
150
<li><a name='toc4' href='#sect4'>Examples</a></li>
 
151
<li><a name='toc5' href='#sect5'>CRcd $HOME/public_htmlmv index.html index.html.oldhindent -i4 index.html.old > index.htmlSite</a></li>
 
152
<li><a name='toc6' href='#sect6'>Version</a></li>
 
153
<li><a name='toc7' href='#sect7'>Author</a></li>
 
154
</ul>
 
155
</body>
 
156
</html>