perlmacos(1) [redhat man page]

PERLMACOS(1)						 Perl Programmers Reference Guide					      PERLMACOS(1)

NAME

       README.macos - Perl under Mac OS (Classic)

SYNOPSIS

       This document briefly describes perl under Mac OS (Classic).  If you are running perl under Mac OS X, you don't want to be here (unless you
       are in the Classic environment under Mac OS X).

       When we say "Mac OS" below, we mean Mac OS 7, 8, and 9, and not Mac OS X.

DESCRIPTION

       The latest perl source itself builds on Mac OS, with some additional pieces. Support for Mac OS is now in the perl core, and MacPerl is
       kept in close sync with regular perl releases.

       To build perl for Mac OS (as an MPW tool), you will need the addition of the macos subdirectory, distributed separately.  It includes extra
       source files, config files, and make files.  It also includes extra Mac-specific modules.

       To build the MacPerl application, you will also need the macperl directory, which includes the source files for creating the application
       itself.

       All of this is available from the development site, via HTTP (in the MacPerl Installer, which includes all the source and binaries) and
       anonymous CVS.

	       http://dev.macperl.org/

       The source is also in the main perl repository in the macperl branch (the 5.6 source is in the maint-5.6/macperl branch).

       You will also need compilers and libraries, all of them freely available.  These are linked to from the SourceForge site. Go that site for
       all things having to do with MacPerl development.

       MacPerl 5.6.1 and later are supported on Mac OS 8.1 and later, for 68040 and PowerPC architectures.  The MPW tool may be used on Mac OS
       7.5.5 and 68030 computers.

       MacPerl 5.2.0r4 is also available, on the CPAN and on SourceForge.  It is based on perl 5.004, and works with Mac OS 7.5.5 and 68030 com-
       puters.

AUTHOR

       perl was ported to Mac OS by Matthias Neeracher <neeracher@mac.com>.  It is currently maintained by Chris Nandor <pudge@pobox.com>.

DATE

       Last modified 2002.05.02.

perl v5.8.0							    2003-02-18							      PERLMACOS(1)

MacPerl(3)						User Contributed Perl Documentation						MacPerl(3)

NAME

       MacPerl - Built-in Macintosh specific routines.

SYNOPSIS

	   $phone = MacPerl::Ask("Enter your phone number:");
	   MacPerl::Answer("Nunc et in hora mortis nostrae", "Amen");
	   $color = MacPerl::Pick("What's your favorite color baby ?", "Red", "Green", "Gold");

	   MacPerl::SetFileInfo("MPS ", "TEXT", yin, yang);
	   MacPerl::GetFileInfo(yin);

	   MacPerl::Quit(kMacPerlAlwaysQuit);

FUNCTIONS

       MacPerl::Answer(PROMPT)
       MacPerl::Answer(PROMPT,BUTTON1)
       MacPerl::Answer(PROMPT,BUTTON1,BUTTON2)
       MacPerl::Answer(PROMPT,BUTTON1,BUTTON2,BUTTON3)
	       Presents to the user a dialog with 1, 2, or 3 buttons.

	       Examples:

		   MacPerl::Answer("Nunc et in hora mortis nostrae", "Amen");

	       always returns 0.

		   MacPerl::Answer("I refuse");

	       is equivalent to "MacPerl'Answer("I refuse", "OK");"

		   MacPerl::Answer("Delete hard disk ?", "OK", "Cancel");

	       returns 1 for OK, 0 for Cancel

		   MacPerl::Answer("Overwrite existig file", "Overwrite", "Skip", "Cancel");

	       returns 2 for Overwrite, 1 for Skip, 0 for Cancel

       MacPerl::Ask(PROMPT, DEFAULT)
       MacPerl::Ask(PROMPT)
	       Asks the user for a string. A default value may be given. Returns undef if the dialog is cancelled.

	       Example:

		   $phone = MacPerl::Ask("Enter your phone number:");
		   $name  = MacPerl::Ask("Enter your first name", "Bruce");

	       Useful for Australian database applications

       MacPerl::Pick(PROMPT, VALUES)
	       Asks the user to pick a choice from a list. VALUES is a list of choices.  Returns undef if the dialog is cancelled.

	       Examples:

		   $color = MacPerl::Pick("What's your favorite color baby ?", "Red", "Green", "Gold");

       MacPerl::SetFileInfo(CREATOR,TYPE,FILE...)
	       Changes the file types and creators of the file(s).

	       Examples:

		   MacPerl::SetFileInfo("MPS ", "TEXT", yin, yang);

	       Turn yin and yang into MPW text files

       MacPerl::GetFileInfo(FILE)
	       In scalar context, returns the file type. In array context, returns (creator,type).

	       Examples:

		   MacPerl::GetFileInfo(yin);

	       Returns "TEXT" or ("MPS ", "TEXT").

       MacPerl::DoAppleScript(SCRIPT)
	       Execute an AppleScript script.  Returns the text of the script result.  Script error strings are returned in $@.

	       Example:

		       my $text = MacPerl::DoAppleScript(<<END_SCRIPT) or die $@;
		       tell application "BBEdit"
			       make new Window
			       copy "Inserting text the hard way." to character 1 of front Window
			       get (characters 1 through 9 of front Window) as text
		       end tell
		       END_SCRIPT

	       Note: calling DoAppleScript to tell MacPerl to do something via AppleScript may yield unpredictable results, especially when
	       waiting on MacPerl to reply, such as when stringing multiple events together, or expecting data to be returned.	Try wrapping the
	       "tell" block in "ignoring application responses" / "end ignoring" if necessary.

       MacPerl::Reply(ANSWER)
	       Reply to current DoScript request. Useful if you are calling Perl scripts from other applications.

       MacPerl::Quit(LEVEL)
	       Mac OS only.

	       If LEVEL is 0, don't quit after ending the script. If 1, quit if running under a runtime version, if 2, always quit. If LEVEL is 3,
	       quit if this was the first script to be run since starting MacPerl.

       MacPerl::LoadExternals(LIBFILE)
	       Mac OS only.

	       Load XCMD and XFCN extensions contained in file LIBFILE, which is searched along the same path as it would be for a require. The
	       extensions are made accessible in the current package, unless they containing an explicit package name.

       MacPerl::FAccess(FILE, CMD, ARGS)
	       Mac OS only.

	       When called from the tool, manipulate various information of files. To get the command constants, it's convenient to require
	       "FAccess.ph".

	       $TAB = MacPerl::FAccess(FILE, F_GTABINFO)
	       MacPerl::FAccess(FILE, F_STABINFO, TAB)
		       Manipulate tabulator setting (in spaces per tab).

	       ($FONTNAME, $FONTSIZE) = MacPerl::FAccess(FILE, F_GFONTINFO)
	       $FONTNUM = MacPerl::FAccess(FILE, F_GFONTINFO)
	       MacPerl::FAccess(FILE, F_SFONTINFO, FONT [, SIZE])
		       Manipulate font and size information. Both font names and font numbers are accepted for F_SFONTINFO; F_GFONTINFO returns a
		       font name in an array context, a font number in a scalar context.

	       ($STARTSEL, $ENDSEL, $DISPLAYTOP) = MacPerl::FAccess(FILE, F_GSELINFO)
	       $STARTSEL = MacPerl::FAccess(FILE, F_GSELINFO)
	       MacPerl::FAccess(FILE, F_SSELINFO, $STARTSEL, $ENDSEL [, $DISPLAYTOP])
		       Manipulate the MPW selection of a file.

	       ($LEFT, $TOP, $RIGHT, $BOTTOM) = MacPerl::FAccess(FILE, F_GWININFO) =item $TOP = MacPerl::FAccess(FILE, F_GWININFO) =item
	       MacPerl::FAccess(FILE, F_SWININFO, LEFT, TOP [, RIGHT, BOTTOM])
		       Manipulate the window position.

       MacPerl::MakeFSSpec(PATH)
	       This command encodes a path name into an encoding (volume #, directory #, File name) which is guaranteed to be unique for every
	       file. Don't store this encoding between runs of MacPerl!

       MacPerl::MakePath(FSSPEC)
	       The inverse of MacPerl::MakeFSSpec(): turn an encoding into a path name.

       MacPerl::Volumes()
	       In scalar context, return the FSSPEC of the startup volume. In list context, return FSSPECs of all volumes.

SEE ALSO

       macperl

perl v5.16.2							    2009-09-07								MacPerl(3)