Ticket #6204: diskusage_htmlUpdate.patch

File diskusage_htmlUpdate.patch, 11.8 KB (added by Karvjorm, 14 years ago)

Upgrading html to xhtml transitional

  • docs/apps/diskusage/DiskUsage.html

     
    1 <html>
    2 <head>
     1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
     2                      "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
     3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
     4<head>
    35<title>DiskUsage</title>
     6<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=utf-8" />
    47</head>
     8<body style="background-color: #ffffff;">
     9 
     10<br />
     11<br />
     12<h2><img src="icon.png" alt="DiskUsage icon" />&nbsp;<code>DiskUsage</code><br />Volume Utilization Visualizer</h2>
     13 
     14<hr />
     15 
     16 
     17<h3>What is it?</h3>
     18 
     19<p><code>DiskUsage</code> shows a graphical representation of how the space on your volumes is utilized.  It uses concentric circles to represent different levels in the file system hierarchy.  It is useful for answering the question, "Where has all my disk space gone?"  And sometimes it's fun just to look at the pictures.
     20</p>
    521
    6 <body bgcolor=#ffffff>
     22<p>Here is a picture of <code>DiskUsage</code> in action, so to speak.</p>
     23 
     24<p style="text-align:center;"><img src="home.png" alt="DiskUsage home" /></p>
     25 
     26<p>The circle in the middle represents my <code>/boot/home</code> directory. Each segment of the ring immediately outside that circle represents a file or directory within <code>/boot/home</code>.  And so on.
     27</p>
     28 
     29<h3>Usage</h3>
    730
    8 <br>
    9 <br>
    10 <h2><img src="icon.png">&nbsp;<code>DiskUsage</code><br>
    11 Volume Utilization Visualizer</h2>
     31<p>
     32<strong>Startup.</strong>  You can launch <code>DiskUsage</code> from the <code>Tracker</code>, either directly or by dropping a volume or folder on its icon; or from the <code>Terminal</code>, optionally passing the names of one or more files or folders as arguments.  If you launch <code>DiskUsage</code> without specifying a volume, it will wait until you drop one or more volumes or folders on its window or select a volume from the menu.
     33</p>
    1234
    13 <hr>
     35<p>
     36While <code>DiskUsage</code> is scanning a volume, it displays a status bar showing its progress.  Multiple volumes are scanned in parallel (each in its own thread).  You can view the progress on a volume by selecting that volume from the menu.
     37</p>
    1438
     39<p>
     40<strong>The main display.</strong>  When <code>DiskUsage</code> finishes scanning a volume, it displays a graphical representation of the volume's files and directories.  As you move the mouse over each part of the picture, information about each file or directory appears in the area at the bottom of the window. You can resize the window to increase or decrease the number of levels that <code>DiskUsage</code> displays.
     41</p>
    1542
    16 <h3>What is it?</h3>
     43<p>
     44<strong>Zooming.</strong>  You can "zoom" in on a directory by clicking the primary mouse button on it.  The picture is redrawn with that directory in the center circle.  You can zoom out one level by clicking the center circle.  At the outermost level, the center circle represents the volume itself, showing free and used space as pie slices.
     45</p>
    1746
    18 <code>DiskUsage</code> shows a graphical representation of how the space on your
    19 volumes is utilized.  It uses concentric circles to represent different levels
    20 in the file system hierarchy.  It is useful for answering the question, "Where
    21 has all my disk space gone?"  And sometimes it's fun just to look at the
    22 pictures. <p>
     47<p>
     48<strong>Pop-up menu.</strong>  Clicking the secondary mouse button on a part of the picture pops up a menu with <code>Tracker</code>-like options applicable to that file or directory.  For directories, the menu includes an option to rescan that directory and its subdirectories (not the entire volume).  This is useful since <code>DiskUsage</code> does not monitor changes to the file system.
     49</p>
    2350
    24 Here is a picture of <code>DiskUsage</code> in action, so to speak. <p>
     51<p>
     52<strong>Drag-and-drop.</strong>  You can drag files and directories from <code>DiskUsage</code> to other applications (or to the desktop, the trash, etc.) with the primary mouse button.  You can drop volumes and folders on <code>DiskUsage</code>'s window to zoom directly to them.
     53</p>
    2554
    26 <center><img src="home.png"></center> <p>
     55<p>
     56<strong>Other controls.</strong>  The buttons in the top right corner of the <code>DiskUsage</code> window rescan the selected volume and display the documentation (this file).
     57</p>
     58 
     59<p><strong>Notes:</strong></p>
     60 
     61<ul>
    2762
    28 The circle in the middle represents my <code>/boot/home</code> directory.
    29 Each segment of the ring immediately outside that circle represents a file or
    30 directory within <code>/boot/home</code>.  And so on.
     63<li> If the graphical representation of a file or directory comprises less than about two degrees of a circle, it is excluded from the display.</li>
    3164
     65<li> The number of files that <code>DiskUsage</code> reports for a directory includes files in subdirectories too.  A directory counts as a file.</li>
     66 
     67<li> <code>DiskUsage</code> ignores symbolic links.</li>
     68 
     69<li> If you don't like the colors <code>DiskUsage</code> uses, you can change them with your favorite resource editor.</li>
    3270
    33 <h3>Usage</h3>
     71</ul>
     72 
     73 
     74<h3>Credits, etc.</h3>
    3475
    35 <strong>Startup.</strong>  You can launch <code>DiskUsage</code> from the
    36 <code>Tracker</code>, either directly or by dropping a volume or folder on its
    37 icon; or from the <code>Terminal</code>, optionally passing the names of one
    38 or more files or folders as arguments.  If you launch <code>DiskUsage</code>
    39 without specifying a volume, it will wait until you drop one or more volumes
    40 or folders on its window or select a volume from the menu.  <p>
     76<p>
     77Thanks to Steffen Gerlach for creating the Windows <a href="http://www.steffengerlach.de/freeware/index.html" title="Website of Steffen Gerlach">Scanner</a> utility, from which I took the idea for using concentric circles to represent disk usage.
     78</p>
    4179
    42 While <code>DiskUsage</code> is scanning a volume, it displays a status bar
    43 showing its progress.  Multiple volumes are scanned in parallel (each in its
    44 own thread).  You can view the progress on a volume by selecting that volume
    45 from the menu. <p>
     80<p>
     81Thanks to the <a href="http://www.vim.org/" title="Vim home page">Vim</a> development team for creating the best programmer's editor on the planet, with which <code>DiskUsage</code>'s original code and documentation were lovingly hand-crafted.
     82</p>
    4683
    47 <strong>The main display.</strong>  When <code>DiskUsage</code> finishes scanning
    48 a volume, it displays a graphical representation of the volume's files and
    49 directories.  As you move the mouse over each part of the picture, information
    50 about each file or directory appears in the area at the bottom of the window.
    51 You can resize the window to increase or decrease the number of levels that
    52 <code>DiskUsage</code> displays. <p>
     84<p>
     85Thanks to the folks at <u><span style="color:#0000ff;">B</span><span style="color:#ff0000;">e</span></u> for creating such a kick-butt OS.  It has made programming fun again.
     86</p>
    5387
    54 <strong>Zooming.</strong>  You can "zoom" in on a directory by clicking the
    55 primary mouse button on it.  The picture is redrawn with that directory in the
    56 center circle.  You can zoom out one level by clicking the center circle.  At
    57 the outermost level, the center circle represents the volume itself, showing
    58 free and used space as pie slices. <p>
     88<p>
     89Thanks to Mike Steed for doing the programming.  All the code is original.
     90</p>
    5991
    60 <strong>Pop-up menu.</strong>  Clicking the secondary mouse button on a part
    61 of the picture pops up a menu with <code>Tracker</code>-like options
    62 applicable to that file or directory.  For directories, the menu includes an
    63 option to rescan that directory and its subdirectories (not the entire
    64 volume).  This is useful since <code>DiskUsage</code> does not monitor changes
    65 to the file system. <p>
     92<p>
     93<code>DiskUsage</code> used to be called <code>guido</code> by it's original author. The name <code>guido</code> originated from GUI + <code>du</code> -- the command-line disk usage utility.  Plus, one of his favorite languages, <a href="http://www.python.org/" title="Python home page">Python</a>, was created by a fine programmer named Guido.
     94</p>
     95 
     96<h3>Known problems</h3>
     97 
     98<ul>
     99 
     100<li> You can drop multiple volumes or folders on the icon, but <code>DiskUsage</code> sees only one of them.  Why?</li>
     101 
     102<li> Dropping a floppy disk volume on <code>DiskUsage</code>'s window works, but dropping it on the icon does not work (unless you force it by holding the Ctrl key while you drag).  <em>Why?!</em></li>
     103 
     104</ul>
     105 
     106 
     107<h3>License</h3>
    66108
    67 <strong>Drag-and-drop.</strong>  You can drag files and directories from
    68 <code>DiskUsage</code> to other applications (or to the desktop, the trash, etc.)
    69 with the primary mouse button.  You can drop volumes and folders on
    70 <code>DiskUsage</code>'s window to zoom directly to them. <p>
    71 
    72 <strong>Other controls.</strong>  The buttons in the top right corner of the
    73 <code>DiskUsage</code> window rescan the selected volume and display the
    74 documentation (this file). <p>
    75 
    76 <strong>Notes:</strong>
    77 
    78 <ul>
    79 
    80 <li> If the graphical representation of a file or directory comprises less
    81 than about two degrees of a circle, it is excluded from the display.
    82 
    83 <li> The number of files that <code>DiskUsage</code> reports for a directory
    84 includes files in subdirectories too.  A directory counts as a file.
    85 
    86 <li> <code>DiskUsage</code> ignores symbolic links.
    87 
    88 <li> If you don't like the colors <code>DiskUsage</code> uses, you can change
    89 them with your favorite resource editor.
    90 
    91 </ul>
    92 
    93 
    94 <h3>Credits, etc.</h3>
    95 
    96 Thanks to Steffen Gerlach for creating the Windows
    97 <a href="http://www.steffengerlach.de/freeware/index.html">Scanner</a>
    98 utility, from which I took the idea for using concentric circles to represent
    99 disk usage. <p>
    100 
    101 Thanks to the <a href="http://www.vim.org/">Vim</a> development team for
    102 creating the best programmer's editor on the planet, with which
    103 <code>DiskUsage</code>'s original code and documentation were lovingly
    104 hand-crafted. <p>
    105 
    106 Thanks to the folks at <u><font color=#0000ff>B</font><font
    107 color=#ff0000>e</font></u> for creating such a kick-butt OS.  It has made
    108 programming fun again. <p>
    109 
    110 Thanks to Mike Steed for doing the programming.  All the code is original. <p>
    111 
    112 <code>DiskUsage</code> used to be called <code>guido</code> by it's original
    113 author. The name <code>guido</code> originated from GUI + <code>du</code>
    114  -- the command-line disk usage utility.  Plus, one of his favorite languages,
    115 <a href="http://www.python.org/">Python</a>, was created by a fine programmer
    116 named Guido.
    117 
    118 
    119 <h3>Known problems</h3>
    120 
    121 <ul>
    122 
    123 <li> You can drop multiple volumes or folders on the icon, but
    124 <code>DiskUsage</code> sees only one of them.  Why?
    125 
    126 <li> Dropping a floppy disk volume on <code>DiskUsage</code>'s window works, but
    127 dropping it on the icon does not work (unless you force it by holding the Ctrl
    128 key while you drag).  <em>Why?!</em>
    129 
    130 </ul>
    131 
    132 
    133 <h3>License</h3>
    134 
    135 <code>DiskUsage</code> is Copyright (c) 1999 Mike Steed.  You are free to use
    136 and distribute this software as long as it is accompanied by this documentation
    137 and copyright notice.  The software comes with no warranty, etc. <p>
    138 
    139 <hr>
    140 
    141 </body>
     109<p>
     110<code>DiskUsage</code> is Copyright &copy; 1999 Mike Steed.  You are free to use and distribute this software as long as it is accompanied by this documentation and copyright notice.  The software comes with no warranty, etc.
     111</p>
     112 
     113<hr />
     114 
     115</body>
    142116</html>