16

There appears to be a somewhat standard "descript.ion" file in Windows programs universe which provides meta data for all/some of the files in a given directory.

I know there are various programs which write this file (example: NewsBin, UseNet downloader) and read it (Example: "FAR", a file manager mimicking old Norton Commander).

I'm writing my own file indexer, and would like to add the ability to parse and use the info from "descript.ion" files.

The problem I have is that I have not been able to find an actual spec for the file, despine much googling.

I reverse engineered it as best I could, but I'm not certain whether I captured 100% of the possible details, so I figured I'd ask SO.

Here are example lines from the file:

"Rus Song1.mp3" SovietMus 1/2, [email protected], Fri Aug 08 00:46:27 2008
RusSong2.mp3 SovietMus 2/2, [email protected], Fri Aug 08 01:46:22 2008

As it seems the structure is:

  1. First "token" is a file name.

    • If the token starts with any letter but double quote, the token ends at the first space character.

    • If the token starts with the double quote, the end of token is the following double quote

    • Not sure what happens if filename contains a double quote, IIRC it's illegal in Windows filesystems, so escaping the quote may be a moot question)

  2. Last token (end of line to the very last comma moving backwards) is a timestamp.

  3. Second to last token (the very last comma to second-to-last comma moving backwards) is the name of the poster from the Usenet newsgroup. I'm not quite sure what happens in generic format since the only descript.ion files I saw were from NewsBin that is obviously Usenet centric.

  4. Everything in between is a description, in NewsBin's case coming from post's subject.

QUESTIONs:

  • Does anyone know of a bit more official "descript.ion" file spec/documentation? (or, at elast, have your own knowledge of those files and can verify my spec)

  • Does anyone know of any other programs that read or write this file?

Thanks!

2
  • 3
    The original usage of DESCRIPT.ION was to provide longer more descriptive names to 8.3 filenames; all it had was the shortname and a longer description. As you've found, others have co-opted the name with varying formats and usages. Frankly speaking, I don't think you'll find any specific commonality among the various usages. Commented Nov 27, 2009 at 19:53
  • @Joe - please add this comment as an asnwer so I can accept it. Commented Jan 22, 2010 at 17:41

6 Answers 6

12

The description files on my system are from Total Commander as well. They follow the basic spec mentioned in the other answers:

Filename Text I typed to describe the file
"Long filename" Some text

Each line ends in a normal Windows line break.

In addition, the program stores multi-line comments as follows:

Filename This is the first line\\nSecond line\\nLast line\x04\xc2

Here, I mean that the descript.ion file contains a backslash and a letter 'n' where I typed a line break, and two special characters 04 C2 at the end of the comment. In addition, the line is ended by a Windows line break 0D 0A.

Apparently, the two extra characters at the end of the line signal the end of a multiline comment. If I remove them, the comment is rendered as a single line in the GUI, and the '\n' sequences are displayed literally.

Sign up to request clarification or add additional context in comments.

Comments

11

The original usage of DESCRIPT.ION was to provide longer more descriptive names to 8.3 filenames; all it had was the shortname and a longer description. As you've found, others have co-opted the name with varying formats and usages. Frankly speaking, I don't think you'll find any specific commonality among the various usages.

Comments

9

Format is simple: FileName remainder of the line is a description of the file

https://jpsoft.com/ascii/descfile.txt

(Wayback Machine)

Comments

6

The descript.ion file is extensively used in the file management utility "total commander", a shareware found in www.ghisler.com. From version 7.5 of TC, it can have length of 4096 bytes. I have been using it extensively to annotate my files without any issues. You may look up different user's experience at the total commander users forum.

Pay software. Any affiliation?
Is it open sourced? Can the OP study it? If not this is no answer to the question... SO is about programming not getting some job done with product X
5

the answer above looks correct for me, just a addition:

from http://filext.com/file-extension/ION The ION file type is primarily associated with '4DOS'. Note: Norton Utilities also uses 4DOS.

http://www.optimasc.com/products/fileid/4dos-descext.pdf

Collected links to 4DOS description-aware programs of all kind and 4DOS tools. http://www.4dos.info/4tools.htm

http://drupal.org/node/289988

1

I will add that, judging by the information on this page, in some applications the following syntax for separating the file name with its extension and description is considered acceptable:

filename1.ext: Description of filename1
filename2.ext: Description of filename2
dir1: Description of directory1

Also, please note that the descript.ion file can be saved in UTF (UTF-8 BOM, UTF-16 LE or UTF-16 BE), ISO, KOI and ANSI encodings.

Finally, during the Fidonet era, the descript.ion files used the character sequence "│ │" as a line separator for object descriptions.

Comments

Your Answer

Draft saved
Draft discarded

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Start asking to get answers

Find the answer to your question by asking.

Ask question

Explore related questions

See similar questions with these tags.