Dtree README file for version 2.1 USER COMMANDS DTREE(1) NAME dtree - display directory trees SYNOPSIS dtree [-a, --all-files] [-B, --body spec] [-C, --columns width] [-d, --dirs-first] [-D, --dotfiles] [-F, --font spec] [-f, --files-first] [-g, --group] [-G, --graphics] [-H, --html] [-I, --info] [-l, --long] [-L, --no-symlinks] [-m, --match pattern] [-n, --no-sort] [-R, --regex mode] [-s, --simple] [-U, --url base] [-x, --no-xfs] [-h, --help] [-o, --output filename] [-v, --verbose] [-V, --version] [-W, --warranty] directory ... DESCRIPTION dtree displays a graphic representation of the directory structure of each given directory and its children. If no directories are specified, the current directory is used. By default, only directories, not regular files, are shown, and only their filenames are given. Various options add additional information to the tree. CHANGES FROM PREVIOUS RELEASES Version 2.0: o generates HTML 3.2 output (text and graphics modes) o prints only files that match a certain pattern (e.g., *.html) o if requested, does not list symbolic links of any kind OPTIONS -a, --all Include files in the listing (excluding entries begin- ning with '.'). -B, --body spec Use spec as the tag of the HTML output. Since spec is copied verbatim into the output it should be valid HTML code. -C, --columns width Make width the length of each column of the printout. By default, this is 14. Any entries longer than the column length are truncated accordingly, and the last character that fits into the column is replaced by an asterisk. This option disables the variable width columns that dtree uses by default. -D, --dotfiles Include entries beginning with `.' (except `.' and `..'). Version 2.1 Last change: January 2000 1 USER COMMANDS DTREE(1) -d, --dirs-first List directories first. For each directory, its subdi- rectories will be listed first, and then all of its other entries. -f, --files-first List files first. The reverse of -d, --dirs-first. -F, --font spec Use spec as the initial tag of the HTML output. Since spec is copied verbatim into the output it must be valid HTML code. -l, --long Long listing. Display useful information to the right of each entry: the name of the file's owner, its size in blocks, and its mode. -g, --group Same as the -l, --long option, except that the group name is used instead of the owner name. If both the -l, --long and -g, --group options are used, both the owner and group will be displayed. -G, --graphics Create HTML 3.2 compatible output, but use GIF images for the tree structure, rather than ASCII as in -H, --html mode. All directories and files, depending on the other options given are clickable hyper-links to their respective files. -H, --html Create HTML 3.2 compatible output, rather than ASCII. All directories and files, depending on the other options given are clickable hyper-links to their respective files. -I, --info Display a header at the top of the printout that gives the time and date that the printout was made and a sum- mary of the type of information contained in the tree. -L, --no-symlinks Do not print files that are symbolic links, either of links to directories or files. -m, --match pattern Do only include those files in the output that match pattern. Pattern is a POSIX.2 compatible regular expression (cf GNU REGEX library). The syntax, i.e., flavour or style of pattern can be set using the -R, --regex flag. Version 2.1 Last change: January 2000 2 USER COMMANDS DTREE(1) -n, --no-sort No sort. Entries are listed in the order they are read from the directories. -R, --regex mode Choose a syntax, i.e., flavour or style of the regular expression pattern set with the -m, --match option. Since dtree makes use of the GNU REGEX library, you can choose among the following 9 styles, you may give the number, i.e., numerical value or the string identifier: `1' or `EMACS', `2' or `AWK', `3' or `POSIX-AWK', `4' or `GREP', `5' or `EGREP', `6' or `POSIX-EGREP', `7' or `ED', `8' or `SED', `9' or `POSIX EXTENDED'. With EMACS syntax being the default mode. -s, --simple Simplify the long listing: display the user id, size in blocks, and octal mode of the file. This option implies the -l, --long option unless the -g, --group option is specified. -U, --url base By default dtree assumes that the local file system is used to reference the files in the URLs of the HTML output, i.e., all URLs are relative wrt to the current filesystem dtree traverses. If you want to point dtree's output to some other location, you can use this option and prepend the base given as a new base to all URLs in dtree's output. -x, --no-xfs Do not cross file systems. dtree will not cross over to a subdirectory if it is on a different file system. -h, --help Print usage information on stderr. -o, --output filename The output is written to file filename. -v, --verbose Print miscellaneous runtime informations to stderr. -V, --version Print the version number on stderr. -W, --warranty Print warranty information on stderr. EXAMPLES To give no option at all is the same as to give the command: dtree . Version 2.1 Last change: January 2000 3 USER COMMANDS DTREE(1) |-doc- |-dtree-2.0-|-lib- |-man- |-src- While dtree -a -m '\.c$' gets: |-doc- | | |-alloca.c | |-error.c | |-getopt.c |-lib-|-getopt1.c |-dtree-2.0-| |-regex.c | |-strtol.c | |-xmalloc.c | |-xstrdup.c |-man- | |-src-|-dtree.c Since release 2.0 dtree is also capable to produce HTML out- put. dtree -H . for example, results in something like: `/EUnet/research/joke/src/dtree-2.0' as of Sat Nov 16 15:42:24 1996. 

                      |-doc-
          |-dtree-2.0-|-lib-
                      |-man-
                      |-src-

created with dtree 2.0.
copyright © 1996-1999 by -joke. all rights reserved.
 Version 2.1 Last change: January 2000 4 USER COMMANDS DTREE(1) For an encore, try the following: dtree -H -I -L -a -m '\\.c$ -v -U file://dtree-2.0/ -B '' Real world demos of website navigation aids built using dtree include BOOKLAND: http://surf.de.uu.net/bookland/dtree.html WEBLAND: http://surf.de.uu.net/webland/dtree.html SEE ALSO find(1), regex(3). BUGS Bugs? In my programs? Are you kidding?? Ok. ``-G, -- graph- ics'' is still missing. AUTHOR Release 2.1 is based on David MacKenzie's 1994 release 1.9. Copyright (c) 1996 by Joerg Heitkoetter. All rights reserved. Send bugs, comments, and all the fish to joke@de.uu.net ORIGINAL AUTHOR Dave Borman Originally written at St. Olaf College, Northfield, MN. Modified by several other people since then. AVAILABILITY Dtree has been posted to USENET's alt.sources and comp.sources.misc and is consequently available from your local news archive; e.g. by anonymous ftp from ftp.de.uu.net in directory /pub/newsarchive It's also available via ANONYMOUS FTP: ftp://ftp.de.uu.net/pub/utils/www/dtree-2.1.tar.gz WORLD-WIDE WEB: http://research.de.uu.net:8080/~gnu/dtree/dtree-2.1.tar.gz WARRANTY This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later ver- sion. Version 2.1 Last change: January 2000 5 USER COMMANDS DTREE(1) This program is distributed in the hope that it will be use- ful, but WITHOUT ANY WARRANTY; without even the implied war- ranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PUR- POSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, 59 Temple Place--Suite 330, Boston, MA 02111-1307, USA. EPILOGUE Release 2.1 was prepared under the influence of some pretty cool music, most notably Van Halen's ``Best Of Volume I'' album, Warner Bros., http://www.wbr.com/vanhalen/, 1996. (Play it load with lights turned off!) Have fun. Version 2.1 Last change: January 2000 6