xdeview.1

来自「UUDeview是一个编码解码器」· 1 代码 · 共 536 行 · 第 1/2 页

.B List Text File
This is for the rare cases when a text file has been sent through
the net in encoded form. Use this action only when you know the
file in question is in fact a text file, otherwise you'll get a
load of trash on the screen.
.RE
.TP
.B Help
.RS
.TP
.B About
A short message from the Author.
.TP
.B License
Displays the license under which xdeview is distributed, the
.B GPL.
Read it, or you'll hear from my lawyers. 
.SH FILE LIST
The File List is a list box displaying all the files that have been
picked up while scanning the encoded data. These files are ready for
decoding, previewing or anything. The list can be scrolled using the
scrollbar on the right of the list.
.PP
Individual files can be selected simply by clicking on them. Multiple
files can be selected by holding down the
.I CTRL
key and clicking on the individual files.
.SH STATUS LIST
The Status Lists notes the corresponding status for each file in the
.I File List,
Usually, you'll just see "OK" here; otherwise, an error message is
shown describing why the file cannot be decoded properly. There are
the following states:
.TP
.B OK
All parts of the file have been found, and the encoded data looks
correct on first sight. There are certain problems that might only
appear when decoding the file, but usually everything is fine.
.TP
.B Incomplete
This file is missing one or more parts. If you decode this file, the
output data will be corrupt and usually unusable.
.TP
.B No Begin
The file doesn't have a beginning. The decoded file will be most
certainly corrupt and unusable.
.TP
.B No End
No end was found on the file. This usually means that one or more
parts at the end are missing. The degree of usefulness of a decoded
file depends on the file type.
.TP
.B Error
A previous attempt to decode the file has failed.
.SH SHORT-CUT BUTTONS
The buttons on the right side of the window are short-cuts for the
menu items. Read the discussion of the Main Menu items above for an
explanation.
.SH SAVE PATH
This is the path where decoded files will be written to.
.SH STATUS
A short message what the program is currently doing or what it expects
you to do.
.SH ENCODING MENU
When encoding files ("Encode" from the "File" menu), a large dialog
box opens where you can set various options for the file. If you
selected multiple files for encoding, a status line at the top
displays the number of files left. The dialog itself stays open
until all files have been handled.
.TP
.B Filename
The current file to encode. You cannot edit this field.
.TP
.B Send As
The file name by which the file will be sent. Defaults to the filename
stripped of all directory information.
.TP
.B Use Subject
When mailing or posting, this text will be used as subject. The 
filename and part numbers are added automatically, so you can
choose to leave this line empty.
.TP
.B Lines per File
Sets the number of encoded lines per part. Bigger files will be
automatically split into multiple parts. Use if you are posting files
to a newsgroup, or if the recipient's system cannot handle large
files. A good splitting size is 1000 lines. "0" lines means not to
split.
.TP
.B ... Encoding
Selects the encoding method to use. If you wonder which one's the
best, you might find a clue in my article "Introduction to Decoding".
.TP
.B File In (Path)
Sets a directory where to encode the file to. The encoding will go to
files with the same base name as the original file, but with
extensions of .001, .002 (depending on the number of necessary parts
as enforced by the "Lines per File" setting).
.TP
.B Email To
Give a comma-separated list of email addresses. This option might be
disabled if your system does not allow sending of emails.
.TP
.B Post To
Here you can enter a comma-separated list of newsgroups to which the
file should be posted. This option might be disabled if your system
does not support posting news.
.TP
.B NNTP Server
This field only appears on some systems, in the case that a news host
is needed, but none was configured at compile-time. If this field does
appear, you must enter a valid host name here in order for posting to
work. If you don't want to post the file anyway, don't worry about it.
.TP
.B OK
Performs the selected action(s) on this file and skips to the next one.
.TP
.B OK to All
Uses these settings for each file in question (does not prompt you for
the other files), thus sending all files at once.
.TP
.B Next
Does not encode the file and skips to the next one (sorry, there's no
button to skip backwards).
.TP
.B Cancel
Cancels encoding and returns to the main menu.
.SH SETUP FILE
If it exists, the file
.I .xdeviewrc
in your home directory will be executed in the Tcl interpreter during
program initialization. It must be a valid Tcl program, which you can
use to set certain options by default. For the Tcl-illaterate:
variables can be set using the following syntax:
.PD 0
.PP
.B set var_name value
.PP
.PD
The following variables (options) can be set (look at the text above
for an explanation of what they're doing)
.TP
.B OptionFast
If set to 1, use fast scanning mode.
.TP
.B OptionBracket
If set to 1, use the alternate bracket policy.
.TP
.B OptionOverwrite
If set to 1, assume it's Ok to overwrite files without asking.
.TP
.B OptionDesperate
If set to 1, switch into desperate mode.
.TP
.B OptionVerbose
If set to 1, print progress messages.
.TP
.B SaveFilePath
This is a string variable with the default Save Path, where you want
decoded files to go.
.TP
.B EncodeMaxLines
Maximum number of lines per file for encoding. "0" for unlimited.
.TP
.B EncodeEncoding
Default encoding to use. "0" for UUencoding, "1" for XXencoding and
"2" for Base64 encoding.
.TP
.B NNTPServer
The address of your NNTP server (only needed on some systems). Can
also be set (preferredly) in your environment variable
.I NNTPSERVER.
.SH RUNTIME MESSGAGES
If you have enabled verbose mode, progress messages will appear in an
own text window titled
.I Runtime Messages.
The messages generated during the scanning phase are extremely helpful
in tracing what the program does, and can be used to figure out the
reason why files cannot be decoded, if you understand them. This
section explains how to interpret them. Understanding this section is
not necessary to operate the program.
.PP
First, there are "Loading" messages, which begin with the string
"Loaded". Each line should feature the following items:
.TP
.B Source File
The first item is the source file from which a part was loaded. Many
parts can be detected within a single file.
.TP
.B Subject Line
The complete subject is reproduced in single quotes.
.TP
.B Identifier
The program derives a unique identification for this thread from the
subject line, for grouping articles that look like they belong to the
same file. The result of this algorithm is presented in braces.
.TP
.B Filename
If a filename was detected on the subject line or within the data (for
example, on a begin line, or as part of the Content-Type information).
.TP
.B Part Number
The part number derived from the subject line, or, in the case of
properly MIME-formatted messages, from the "part" information.
.TP
.B Begin/End
If a "begin" or "end" token was detected, it is printed here.
.TP
.B Encoding Type
If encoded data was detected within this part, either "UUdata",
"Base64", "XXdata" or "Binhex" is printed here.
.PP
More messages are printed after scanning has completed. A single line
will be printed for each group of articles. The contents of this line
are best understood by looking at an example. Here is one:
.PP
.B Found 'mailfile.gz' State 16 UUData Parts begin 1 2 3 4 5 end 6 OK
.PP
This indicates that the file
.I mailfile.gz
has been found. The file was uuencoded ("UUData") and consists of
6 parts. The "begin" token was found in the first part, and the
"end" token was found in the sixth part. Because it looks like
everything's there, this file is tagged as being "OK". The
.I State
is a set of bits, where the following values may be or'ed:
.TP
.B 1
Missing Part
.TP
.B 2
No Begin
.TP
.B 4
No End
.TP
.B 8
No encoded data found.
.TP
.B 16
File looks Ok
.TP
.B 32
An error occured during decoding of the file.
.TP
.B 64
File was successfully decoded.
.SH NOTES
If you cannot execute
.I xdeview,
and it reports something like "command not found", but are sure that
the file itself can be found, check the reference to the main file
.I uuwish
at the top of the file.
.SH SEE ALSO
.BR uudeview (1),
.BR uuenview (1),
.BR uudecode (1),
.BR uuencode (1),
.PD 0
.PP
The
.I uudeview
homepage on the Web, 
.PD 0
.PP
http://www.fpx.de/fp/Software/UUDeview/