1[comment {-*- tcl -*- doctools manpage}]
2[manpage_begin fileutil::magic::filetype n 1.0.2]
3[moddesc   {file utilities}]
4[titledesc {Procedures implementing file-type recognition}]
5[category  {Programming tools}]
6[require Tcl 8.4]
7[require fileutil::magic::filetype [opt 1.0.2]]
8[description]
9[para]
10
11This package provides a command for the recognition of file types in
12pure Tcl.
13
14[para]
15
16The core part of the recognizer was generated from a "magic(5)" file
17containing the checks to perform to recognize files, and associated
18file-types.
19
20[para]
21
22[emph Beware!] This recognizer is large, about 276 Kilobyte of
23generated Tcl code.
24
25[list_begin definitions]
26
27[call [cmd ::fileutil::magic::filetype] [arg filename]]
28
29This command is similar to the command [cmd fileutil::fileType].
30
31[para]
32
33The output of the command for the specified file is a string
34describing the type of the file.
35
36[para]
37
38This list will be empty if the type of the file is not recognized.
39
40[list_end]
41
42[section REFERENCES]
43
44[list_begin enumerated]
45[enum]
46[uri ftp://ftp.astron.com/pub/file/ {File(1) sources}]
47
48This site contains the current sources for the file command, including
49the magic definitions used by it. The latter were used by us to
50generate this recognizer.
51
52[list_end]
53
54[section {BUGS, IDEAS, FEEDBACK}]
55
56This document, and the package it describes, will undoubtedly contain
57bugs and other problems.
58
59Please report such in the category [emph {fileutil :: magic}] of the
60[uri {http://sourceforge.net/tracker/?group_id=12883} {Tcllib SF Trackers}].
61
62Please also report any ideas for enhancements you may have for either
63package and/or documentation.
64
65
66[see_also fileutil file(1) magic(5)]
67[keywords type {file utilities} {file type} {file recognition}]
68[manpage_end]
69