man/man1/megatron.1.in

   1 '\" t
   2 .\"     Title: megatron
   3 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
   4 .\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/>
   5 .\"      Date: 02 Sep 2011
   6 .\"    Manual: @NETATALK_VERSION@
   7 .\"    Source: @NETATALK_VERSION@
   8 .\"  Language: English
   9 .\"
  10 .TH "MEGATRON" "1" "02 Sep 2011" "@NETATALK_VERSION@" "@NETATALK_VERSION@"
  11 .\" -----------------------------------------------------------------
  12 .\" * Define some portability stuff
  13 .\" -----------------------------------------------------------------
  14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15 .\" http://bugs.debian.org/507673
  16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18 .ie \n(.g .ds Aq \(aq
  19 .el       .ds Aq '
  20 .\" -----------------------------------------------------------------
  21 .\" * set default formatting
  22 .\" -----------------------------------------------------------------
  23 .\" disable hyphenation
  24 .nh
  25 .\" disable justification (adjust text to left margin only)
  26 .ad l
  27 .\" -----------------------------------------------------------------
  28 .\" * MAIN CONTENT STARTS HERE *
  29 .\" -----------------------------------------------------------------
  30 .SH "NAME"
  31 megatron, unhex, unbin, unsingle, hqx2bin, single2bin, macbinary \- Macintosh file format transformer
  32 .SH "SYNOPSIS"
  33 .HP \w'\fBmegatron\fR\fB\fR\fBunbin\fR\fB\fR\fBunhex\fR\fB\fR\fBunsingle\fR\fB\fR\fBhqx2bin\fR\fB\fR\fBsingle2bin\fR\fB\fR\fBmacbinary\fR\fB\fR\ 'u
  34 \fBmegatron\fR\fB\fR [\fIsourcefile\fR...]
  35 .br
  36 \fBunbin\fR\fB\fR [\fIsourcefile\fR...]
  37 .br
  38 \fBunhex\fR\fB\fR [\fIsourcefile\fR...]
  39 .br
  40 \fBunsingle\fR\fB\fR [\fIsourcefile\fR...]
  41 .br
  42 \fBhqx2bin\fR\fB\fR [\fIsourcefile\fR...]
  43 .br
  44 \fBsingle2bin\fR\fB\fR [\fIsourcefile\fR...]
  45 .br
  46 \fBmacbinary\fR\fB\fR [\fIsourcefile\fR...]
  47 .SH "DESCRIPTION"
  48 .PP
  49 \fBmegatron\fR
  50 is used to transform files from BinHex, MacBinary, AppleSingle, or
  51 \fBnetatalk\fR
  52 style AppleDouble formats into MacBinary or
  53 \fBnetatalk\fR
  54 style AppleDouble formats\&. The
  55 \fBnetatalk\fR
  56 style AppleDouble format is the file format used by
  57 \fBafpd,\fR
  58 the
  59 \fBnetatalk\fR
  60 Apple Filing Protocol (AppleShare) server\&. BinHex, MacBinary, and AppleSingle are commonly used formats for transferring Macintosh files between machines via email or file transfer protocols\&.
  61 \fBmegatron\fR
  62 uses its name to determine what type of transformation is being asked of it\&.
  63 .PP
  64 If
  65 \fBmegatron\fR
  66 is called as
  67 \fBunhex\fR
  68 ,
  69 \fBunbin\fR
  70 or
  71 \fBunsingle\fR, it tries to convert file(s) from BinHex, MacBinary, or AppleSingle into AppleDouble format\&. BinHex is the format most often used to send Macintosh files by e\-mail\&. Usually these files have an extension of "\&.hqx"\&. MacBinary is the format most often used by terminal emulators "on the fly" when transferring Macintosh files in binary mode\&. MacBinary files often have an extension of "\&.bin"\&. Some Macintosh LAN\-based email packages use uuencoded AppleSingle format to "attach" or "enclose" files in email\&. AppleSingle files don\*(Aqt have a standard filename extension\&.
  72 .PP
  73 If
  74 \fBmegatron\fR
  75 is called as
  76 \fBhqx2bin\fR,
  77 \fBsingle2bin\fR, or
  78 \fBmacbinary\fR, it will try to convert the file(s) from BinHex, AppleSingle, or AppleDouble into MacBinary\&. This last translation may be useful in moving Macintosh files from your
  79 \fBafpd\fR
  80 server to some other machine when you can\*(Aqt copy them from the server using a Macintosh for some reason\&.
  81 .PP
  82 If
  83 \fBmegatron\fR
  84 is called with any other name, it uses the default translation, namely
  85 \fBunhex\fR\&.
  86 .PP
  87 If no source file is given, or if
  88 \fIsourcefile\fR
  89 is `\fB\-\fR\*(Aq, and if the conversion is from a BinHex or MacBinary file,
  90 \fBmegatron\fR
  91 will read from standard input\&.
  92 .PP
  93 The filename used to store any output file is the filename that is encoded in the source file\&. MacBinary files are created with a "\&.bin" extension\&. In the case of conflicts, the old file is overwritten!
  94 .SH "OPTIONS"
  95 .PP
  96 \fB\-v, \-\-version\fR
  97 .RS 4
  98 Show version\&.
  99 .RE
 100 .SH "SEE ALSO"
 101 .PP
 102 \fBafpd\fR(8)