OS/2 Shareware BBS: 35 Internet/35-Internet.zip/pmuue144.zip/PMUUE.HLP

OS/2 Help File | 1996-08-08 | 15KB | 480 lines

ΓòÉΓòÉΓòÉ 1. Help for Encoding ΓòÉΓòÉΓòÉ

This menu option allows you to convert binary files into UUencoded files.

Selecting this menu item will display a dialog box which allows you to select
the files that you want to UUencode.  After the selection is complete, click on
the "OK" button to start the encoding.

The encoding parameters are determined by the Settings notebook.  For more
information about setting the parameters, see The Settings Notebook for more
details.


ΓòÉΓòÉΓòÉ 2. Help for Decoding ΓòÉΓòÉΓòÉ

This menu option allows you to convert UUencoded files back to binary files.

Selecting this menu item will display a dialog box which allows you to select
the files that you want to UUdecode.  After the selection is complete, click on
the "OK" button to start the decoding.


ΓòÉΓòÉΓòÉ 3. Help for Exit ΓòÉΓòÉΓòÉ

This menu option will end the program.  If there is any encoding or decoding
taking place, the program will ask you if you are sure that you want to abort
the process and exit the program.


ΓòÉΓòÉΓòÉ 4. Help for Settings ΓòÉΓòÉΓòÉ

This menu option will display a settings notebook from which you can change the
behaviour of PMUUE.

For more information about the Settings notebook, see The Settings Notebook for
more details.


ΓòÉΓòÉΓòÉ 5. Help for Menu Item "Help index..." ΓòÉΓòÉΓòÉ

This menu item will display a help index for help with PMUUE.


ΓòÉΓòÉΓòÉ 6. Help for Menu Item "General help..." ΓòÉΓòÉΓòÉ

To UUencode a file:

   1. Press Ctrl-E or select "Encode..." from the "File" menu

   2. Select the files to UUencode from the file dialog

   3. Select "OK" when finished selection

 The program should UUencode the files at this time.

 To UUdecode a file:

   1. Press Ctrl-D or select "Decode..." from the "File" menu

   2. Select the file to UUdecode from the file dialog

      Note:  The selected files must be in UUencoded form

   3. Select "OK" when finished selection

 The program should UUdecode the files at this time.


ΓòÉΓòÉΓòÉ 7. Help for Menu Item "Keys help..." ΓòÉΓòÉΓòÉ

This menu option will display some available keystrokes allowed in the main
window.


ΓòÉΓòÉΓòÉ 8. Help for Menu Item "Using help..." ΓòÉΓòÉΓòÉ

This menu option will display instructions on how to use help.


ΓòÉΓòÉΓòÉ 9. Help for About ΓòÉΓòÉΓòÉ

This dialog box displays information about PMUUE including the author's name
and the version.


ΓòÉΓòÉΓòÉ 10. The Settings Notebook ΓòÉΓòÉΓòÉ

This dialog box controls the behaviour of PMUUE.  It sets the parameters for
many aspects of the program.

The OK button will set the parameters for this session only.  The Cancel button
will not change any of the parameters.  The Save button will set the parameters
for this and future sessions.

For more information about each page of the settings notebook, choose one of
the following:

     The EOL Page
     The Notification Page
     The Directories Page
     The Multi-part Page
     The Drag and Drop Page
     The Miscellaneous Page


ΓòÉΓòÉΓòÉ 11. The Save Button ΓòÉΓòÉΓòÉ

This button will save the current settings for this and future sessions.


ΓòÉΓòÉΓòÉ 12. The EOL Page ΓòÉΓòÉΓòÉ

This page determines what PMUUE will use as an End-Of-Line marker when
uuencoding files.

In DOS and OS/2, the End-Of-Line marker is represented by a carriage return
(ASCII character 13) followed by a linefeed character (ASCII character 10).

In UNIX, the End-Of-Line marker is represented by just a linefeed character.


ΓòÉΓòÉΓòÉ 13. The OS/2 Text Radio Button ΓòÉΓòÉΓòÉ

Choose this button to have UUencoded files end each line with a carriage return
(ASCII character 13) and a linefeed (ASCII character 10).


ΓòÉΓòÉΓòÉ 14. The UNIX Text Redio Button ΓòÉΓòÉΓòÉ

Choose this button to have UUencoded files end each line with a linefeed only
(ASCII character 10).


ΓòÉΓòÉΓòÉ 15. The Notification Page ΓòÉΓòÉΓòÉ

This page is used to control what windows PMUUE will use to communicate with
the user.

For more information, choose one of the following:

     The Log Window
     The Message Box
     The Status Line


ΓòÉΓòÉΓòÉ 16. The Log Window ΓòÉΓòÉΓòÉ

This checkbox will determine whether or not the Log Window is used.

The Log Window is the main listbox window located under the menu but above the
status line.


ΓòÉΓòÉΓòÉ 17. The Message Box ΓòÉΓòÉΓòÉ

This checkbox will determine whether or not message boxes will be used.

Message boxes are dialog boxes which appear whenever a significant event has
happened.  The only option that the user has once one of these message boxes
appear is to select OK to dismiss it.


ΓòÉΓòÉΓòÉ 18. The Status Line ΓòÉΓòÉΓòÉ

This checkbox will determine whether or not the Status Line is used.

The Status Line is used to display the last significant event that has
happened.  The Status Line is the text window located below the log window.


ΓòÉΓòÉΓòÉ 19. The Directories Page ΓòÉΓòÉΓòÉ

This page is used to control which directories PMUUE will use by default.

For more information about each item, select one of the following:

     The Default Binary Directory
     The Default UUencode Directory
     The Default Extension


ΓòÉΓòÉΓòÉ 20. The Default Binary Directory ΓòÉΓòÉΓòÉ

This entry field contains the default directory to use to look for binary
files.  This directory is used as a default for the dialog box for the encode
menu item and when decoding a UUencoded file.

Note:  This directory is set only at the beginning of each session.


ΓòÉΓòÉΓòÉ 21. The Default UUencode Directory ΓòÉΓòÉΓòÉ

This entry field contains the default directory to use to look for UUencoded
files.  This directory is used as a default for the dialog box for the decode
menu item and when encoding a binary file.

Note:  This directory is set only at the beginning of each session.


ΓòÉΓòÉΓòÉ 22. The Default Extension ΓòÉΓòÉΓòÉ

This entry field is the default extension to use for single part UUencoded
files.  For more information about multi-part UUencoded files, see The
Multi-part Page.


ΓòÉΓòÉΓòÉ 23. The Miscellaneous Page ΓòÉΓòÉΓòÉ

This page is for any other settings which are not significant enough to have
its own page.

For more information about each item, select one of the following:

     Max Log Length
     INI File
     Allow Lowercase Characters


ΓòÉΓòÉΓòÉ 24. Max Log Length ΓòÉΓòÉΓòÉ

This entry field determines the maximum number of lines allowed in the Log
Window.  By default number is 500, the minimum number allowed is 5, and the
maximum number is 10000.


ΓòÉΓòÉΓòÉ 25. INI File ΓòÉΓòÉΓòÉ

This entry field determines where the INI file for PMUUE is placed and the name
of the INI file itself.

Note:  The program will not save the current parameters if the user changes the
INI file.  It is up to the user to select the Save button.


ΓòÉΓòÉΓòÉ 26. The "Allow Lowercase Characters" Checkbox ΓòÉΓòÉΓòÉ

This checkbox determines if PMUUE should allow lowercase letters to be valid
UUencode characters when decoding.

Some UUencoders are using lowercase characters as part of their encoding
scheme.  This may get around the problem of lines with spaces on the end of
them but it could introduce problems for a UUdecoder.  For a UUdecoder to be
able to handle the old and new codes, it has to allow all printable characters
as valid UUencode characters. This greatly increases the chance that an
ordinary line of text could be interpreted as an UUencoded line, adding garbage
to the final binary.

If the final binary file contains some sort of garbage and this switch is on,
try removing all lines that are not UUencoded and try again.


ΓòÉΓòÉΓòÉ 27. The Multi-part Page ΓòÉΓòÉΓòÉ

This page is used to determine if PMUUE will create multi-part UUencoded files
or not.

For more information about each item, select one of the following:

     Create Multiple Part Encoding
     The "Max. part size in KB" Radio Button
     The Kilobyte Entry Field
     The "Max. part size in lines" Radio Button
     The Lines Entry Field
     Allow Multiple Part Decoding


ΓòÉΓòÉΓòÉ 28. Create Multiple Part Encoding ΓòÉΓòÉΓòÉ

This checkbox determines whether PMUUE will generate multi-part UUencoded files
or not.

If multi-part files are used, then each part will have a filename with an
extension of .u## where ## is from 01 to 99.


ΓòÉΓòÉΓòÉ 29. The "Max. part size in KB" Radio Button ΓòÉΓòÉΓòÉ

This radio button indicates that the size of each part will be determined by a
maximum size in kilobytes (K).


ΓòÉΓòÉΓòÉ 30. The "Max. part size in lines" Radio Button ΓòÉΓòÉΓòÉ

This radio button indicates that the size of each part will be determined by a
maximum size in the number of lines produced by the encoding.


ΓòÉΓòÉΓòÉ 31. The Kilobyte Entry Field ΓòÉΓòÉΓòÉ

This entry field indicates the maximum size of each part in kilobytes. The
minimum value allowed in this field is 2 and the maximum is 999.  The default
value is 64.

Note:  The program might exceed this limit by a little bit so specify one
kilobyte less than the maximum that you would like.


ΓòÉΓòÉΓòÉ 32. The Lines Entry Field ΓòÉΓòÉΓòÉ

This entry field indicates the maximum number of lines allowed for each part.
The minimum value is allowed is 10 and the maximum is 9999.  The default value
is 980.

Note:  The program might exceed this limit by a little but so specify two lines
less that the maximum that you would like.


ΓòÉΓòÉΓòÉ 33. Allow Multiple Part Decoding ΓòÉΓòÉΓòÉ

This checkbox changes an assumption that PMUUE makes when decoding files.

If this checkbox is checked, then a binary file can be spread across multiple
UUencoded files but the order of the files must be the same as they appear in
the "Decode" dialog box.

When this checkbox is not checked, PMUUE assumes that each UUencoded file
contains entire binary files.


ΓòÉΓòÉΓòÉ 34. The Drag and Drop Page ΓòÉΓòÉΓòÉ

This page is for settings which control the Drag and Drop features of this
program.

For more information about each item, select one of the following:

     Decode
     Encode
     Prompt
     Sort file names


ΓòÉΓòÉΓòÉ 35. Decode ΓòÉΓòÉΓòÉ

This radio button specifies that any files dropped over the log window will
automatically be UUdecoded.

Note:  This option is not used when PMUUE is started from the command line.


ΓòÉΓòÉΓòÉ 36. Encode ΓòÉΓòÉΓòÉ

This radio button specifies that any files dropped over the log window will
automatically be UUencoded.

Note:  This option is not used when PMUUE is started from the command line.


ΓòÉΓòÉΓòÉ 37. Prompt ΓòÉΓòÉΓòÉ

This radio button specifies that any files dropped over the log window will
open a dialog box asking if the dropped files should be UUencoded or UUdecoded.

Note:  This option is not used when PMUUE is started from the command line.


ΓòÉΓòÉΓòÉ 38. Sort file names ΓòÉΓòÉΓòÉ

This check box indicates if the list of dropped files should be sorted before
they are UUencoded or UUdecoded.

Note:  This option is not used when PMUUE is started from the command line.


ΓòÉΓòÉΓòÉ 39. PMUUE Extended Help ΓòÉΓòÉΓòÉ

This program was created to perform two main functions:

     Converting a binary file to a UUencoded file
     Converting a UUencoded file to a binary file

 For an explanation on how to convert a binary file to a UUencoded file, see
 Encoding a file.

 For an explanation on how to convert a UUencoded file to a binary file, see
 Decoding a file.


ΓòÉΓòÉΓòÉ 40. PMUUE Keys ΓòÉΓòÉΓòÉ

From the main window, you can press:

     F10  Menu

     Ctrl-D  Decode a UUencoded file to a binary file

     Ctrl-E  Encode a binary file to a UUencoded file

     Alt-F4  Exit application

     Alt-F9  Minimize window

     Alt-F10  Maximize window


ΓòÉΓòÉΓòÉ 41. What is PMUUE? ΓòÉΓòÉΓòÉ

PMUUE stands for "Presentation Manager Unix-to-Unix Encoder/decoder. "

Basically, this program can convert a binary file into UUencoded format or
convert a file from UUencoded format back into a binary file.

A UUencoded file is a file in a special coded format such that all the data in
that file is a printable character.  This format is used to transport files
through text-based media such as an Internet newsgroup.


ΓòÉΓòÉΓòÉ 42. Encoding a file ΓòÉΓòÉΓòÉ

To UUencode a file:

   1. Press Ctrl-E or select "Encode..." from the "File" menu

   2. Select the files to UUencode from the file dialog

   3. Select "OK" when finished selection

 The program should UUencode the files at this time.

 Note:  The behavior of the encoding process will depend on The Settings
 Notebook.


ΓòÉΓòÉΓòÉ 43. Decoding a file ΓòÉΓòÉΓòÉ

To UUdecode a file:

   1. Press Ctrl-D or select "Decode..." from the "File" menu

   2. Select the files to UUdecode from the file dialog

      Note:  The selected files must be in UUencoded format.

      Note:  When decoding multi-part files, those files must appear in the
      correct order in the dialog box.  Select all the UUencoded files
      associated with a binary file when decoding.

   3. Select "OK" when finished selection

 The program should UUdecode the files at this time.

 Note:  The behavior of the encoding process will depend on The Settings
 Notebook.


ΓòÉΓòÉΓòÉ 44. Command Line Arguments ΓòÉΓòÉΓòÉ

Files specified as command line arguments will automatically be UUdecoded by
default using the settings in the INI file. Wildcard symbols are accepted in
filenames.

Note:  The program will automatically close itself if any command line
parameters are specified by default.

The command line switches are:

     -c:[NO|{delay}]

      This switch will determine how long PMUUE will remain open after encoding
      or decoding a file.  Use "-c:NO" to keep PMUUE open after running or
      "-c:{delay}" to specify how long PMUUE will remain open after running
      where {delay} is the number of milliseconds to remain open.  If this
      parameter is not specified, PMUUE will automatically close five seconds
      after it finishes encoding or decoding files.

      Note:  If the user clicks in the client area before the window closes,
      PMUUE will not close itself automatically.  This is handy if errors occur
      and the user wants to take a closer look at them.

     -d

      This switch will UUdecode any file specified after this switch until a
      "-e" switch is encountered.

     -e

      This command will UUencode any file specified after this switch until a
      "-d" switch is encountered.