AlphaWiki/Commands/The [getStandardFolder] command

December 30, 2007, at 09:08 AM by 77.57.34.27 -

Changed lines 162-163 from:

Note: Further codes not listed in above table together with some technical details may be found at http://developer.apple.com/documentation/Carbon/Reference/Folder_Manager/Reference/reference.html#//apple_ref/c/tdef/FolderType.

to:

Note: Above list contains only the more commonly used folders. A complete list of codes together with further technical details may be found at http://developer.apple.com/documentation/Carbon/Reference/Folder_Manager/Reference/reference.html#//apple_ref/c/tdef/FolderType.

December 30, 2007, at 09:04 AM by 77.57.34.27 -

Added lines 161-163:

Note: Further codes not listed in above table together with some technical details may be found at http://developer.apple.com/documentation/Carbon/Reference/Folder_Manager/Reference/reference.html#//apple_ref/c/tdef/FolderType.

December 29, 2007, at 04:28 PM by bd - Completed list of supported codes

Changed lines 34-42 from:

System Folder	macs
Desktop Folder	desk
System Desktop Folder	sdsk
Trash Folder	trsh
System Trash Folder	strs
Where To Empty Trash Folder	empt
Print Monitor Docs Folder	prnt
Startup Folder	strt
Shutdown Folder	shdf

to:

ALM Locations Folder	fall
ALM Modules Folder	walk
ALM Preferences Folder	trip
Appearance Folder	appr
Apple Extras Folder	aexƒ

Changed lines 40-51 from:

Control Panel Folder	ctrl
System Control Panel Folder	sctl
Extension Folder	extn
Fonts Folder	font
Preferences Folder	pref
System Preferences Folder	sprf
Temporary Folder	temp
Extension Disabled Folder	extD
Control Panel Disabled Folder	ctrD
System Extension Disabled Folder	macD
Startup Items Disabled Folder	strD
Shutdown Items Disabled Folder	shdD

to:

Apple Share Authentication Folder	auth
Apple Share Support Folder	shar
Application Support Folder	asup

Changed lines 44-45 from:

Documents Folder	docs
Volume Root Folder	root

to:

Assistants Folder	astƒ
Audio Alert Sounds Folder	alrt
Audio Components Folder	acmp
Audio Plug Ins Folder	aplg
Audio Sound Banks Folder	bank
Audio Sounds Folder	asnd
Audio Support Folder	adio
Boot Time Startup Items Folder	empz'
Cached Data Folder	cach
Carbon Library Folder	carb

Changed lines 55-71 from:

Application Support Folder	asup
Text Encodings Folder	ƒtex
Stationery Folder	odst
Open Doc Folder	odod
Open Doc Shell PlugIns Folder	odsp
Editors Folder	oded
Open Doc Editors Folder	ƒodf
Open Doc Libraries Folder	odlb
Gen Editors Folder	ƒedi
Help Folder	ƒhlp
Internet Plug In Folder	ƒnet
Modem Scripts Folder	ƒmod
Printer Description Folder	ppdf
Printer Driver Folder	ƒprd
Scripting Additions Folder	ƒscr
Shared Libraries Folder	ƒlib
Voices Folder	fvoc

to:

Classic Desktop Folder	sdsk
Color Sync CMMFolder	ccmm
Color Sync Folder	sync
Color Sync Profiles Folder	prof
Color Sync Scripting Folder	cscr
Components Folder	cmpd
Contextual Menu Items Folder	cmnu
Control Panel Disabled Folder	ctrD
Control Panel Folder	ctrl

Changed lines 65-78 from:

Assistants Folder	astƒ
Utilities Folder	utiƒ
Apple Extras Folder	aexƒ
Contextual Menu Items Folder	cmnu
Mac OS ReadMe Files Folder	morƒ
ALM Modules Folder	walk
ALM Preferences Folder	trip
ALM Locations Folder	fall
Color Sync Profiles Folder	prof
Themes Folder	thme
Favorites Folder	favs
Internet Folder	intƒ
Appearance Folder	appr
Sound Sets Folder	snds

to:

Core Services Folder	csrv
Desktop Folder	desk

Changed lines 68-69 from:

Internet Search Sites Folder	issf
Find Support Folder	fnds

to:

Developer Docs Folder	ddoc
Developer Folder	devf
Developer Help Folder	devh
Directory Services Folder	dsrv
Directory Services Plug Ins Folder	dplg
Display Extensions Folder	dspl
Documentation Folder	info
Documents Folder	docs
Domain Library Folder	dlib
Domain Top Level Folder	dtop
Editors Folder	oded
Extension Disabled Folder	extD
Extension Folder	extn
Favorites Folder	favs
File System Support Folder	fsys

Changed lines 84-85 from:

Installer Logs Folder	ilgf
Scripts Folder	scrƒ

to:

Find By Content Indexes Folder	fbcx
Find Support Folder	fnds

Added lines 87-101:

Fonts Folder	font
Frameworks Folder	fram
Gen Editors Folder	ƒedi
Help Folder	ƒhlp
ISSDownloads Folder	issd
Index Files Folder	indx
Installer Logs Folder	ilgf
Installer Receipts Folder	rcpt
Internet Folder	intƒ
Internet Plug In Folder	ƒnet
Internet Search Sites Folder	issf
Internet Sites Folder	site
Kernel Extensions Folder	kext
Keyboard Layouts Folder	klay
Keychain Folder	kchn

Changed lines 103-109 from:

Recent Applications Folder	rapp
Recent Documents Folder	rdoc
Recent Servers Folder	rsvr
Speakable Items Folder	spki
Keychain Folder	kchn
Quick Time Extensions Folder	qtex
Display Extensions Folder	dspl

to:

MIDI Drivers Folder	midi
Mac OS ReadMe Files Folder	morƒ
Managed Items Folder	mang
Modem Scripts Folder	ƒmod
Movie Documents Folder	mdoc

Added lines 109-119:

Music Documents Folder	doc
Open Doc Editors Folder	ƒodf
Open Doc Folder	odod
Open Doc Libraries Folder	odlb
Open Doc Shell PlugIns Folder	odsp
Picture Documents Folder	pdoc
Preferences Folder	pref
Print Monitor Docs Folder	prnt
Printer Description Folder	ppdf
Printer Driver Folder	ƒprd
Printers Folder	impr

Changed lines 121-122 from:

to:

Private Frameworks Folder	pfrm
Public Folder	pubb
Quick Time Components Folder	wcmp
Quick Time Extensions Folder	qtex
Recent Applications Folder	rapp
Recent Documents Folder	rdoc
Recent Servers Folder	rsvr
Scripting Additions Folder	ƒscr
Scripts Folder	scrƒ
Shared Libraries Folder	ƒlib
Shutdown Folder	shdf
Shutdown Items Disabled Folder	shdD
Sound Sets Folder	snds
Speakable Items Folder	spki
Speech Folder	spch
Startup Folder	strt
Startup Items Disabled Folder	strD
Stationery Folder	odst
System Control Panel Folder	sctl
System Desktop Folder	sdsk
System Extension Disabled Folder	macD
System Folder	macs
System Preferences Folder	sprf
System Sounds Folder	ssnd
System Trash Folder	strs
Temporary Folder	temp
Text Encodings Folder	ƒtex
Themes Folder	thme
Trash Folder	trsh
User Specific Tmp Folder	utmp
Utilities Folder	utiƒ
Voices Folder	fvoc
Volume Root Folder	root
Where To Empty Trash Folder	empt

November 01, 2007, at 04:01 AM by agm - spam cleanup

Deleted line 0:

sitalcatrlet

Changed line 61 from:

Text Encodings Folder

Âƒtex

to:

Text Encodings Folder

ƒtex

Changed line 66 from:

Open Doc Editors Folder

Âƒodf

to:

Open Doc Editors Folder

ƒodf

Changed lines 68-71 from:

Gen Editors Folder	Âƒedi
Help Folder	Âƒhlp
Internet Plug In Folder	Âƒnet
Modem Scripts Folder	Âƒmod

to:

Gen Editors Folder	ƒedi
Help Folder	ƒhlp
Internet Plug In Folder	ƒnet
Modem Scripts Folder	ƒmod

Changed lines 73-75 from:

Printer Driver Folder	Âƒprd
Scripting Additions Folder	Âƒscr
Shared Libraries Folder	Âƒlib

to:

Printer Driver Folder	ƒprd
Scripting Additions Folder	ƒscr
Shared Libraries Folder	ƒlib

Changed lines 78-80 from:

Assistants Folder	astÂƒ
Utilities Folder	utiÂƒ
Apple Extras Folder	aexÂƒ

to:

Assistants Folder	astƒ
Utilities Folder	utiƒ
Apple Extras Folder	aexƒ

Changed line 82 from:

Mac OS ReadMe Files Folder

morÂƒ

to:

Mac OS ReadMe Files Folder

morƒ

Changed line 89 from:

Internet Folder

intÂƒ

to:

Internet Folder

intƒ

Changed line 92 from:

Desktop Pictures Folder

dtpÂƒ

to:

Desktop Pictures Folder

dtpƒ

Changed line 97 from:

Scripts Folder

scrÂƒ

to:

Scripts Folder

scrƒ

Changed line 111 from:

Note: some of the codes in the table above use the Âƒ symbol. This is

to:

Note: some of the codes in the table above use the ƒ symbol. This is

Changed line 120 from:

     Â«MacOSÂ» version

to:

     «MacOS» version

Changed line 123 from:

     Â«MacOSÂ» info command getStandardFolder

to:

     «MacOS» info command getStandardFolder

Changed line 126 from:

     Â«MacOSÂ» getStandardFolder asup user

to:

     «MacOS» getStandardFolder asup user

Changed line 129 from:

     Â«MacOSÂ» getStandardFolder asup local

to:

     «MacOS» getStandardFolder asup local

Changed line 132 from:

     Â«MacOSÂ» getStandardFolder flnt user

to:

     «MacOS» getStandardFolder flnt user

Changed line 135 from:

     Â«MacOSÂ» getStandardFolder -create flnt user

to:

     «MacOS» getStandardFolder -create flnt user

November 01, 2007, at 03:04 AM by 83.174.193.228 -

Added line 1:

sitalcatrlet

Changed line 62 from:

Text Encodings Folder

ƒtex

to:

Text Encodings Folder

Âƒtex

Changed line 67 from:

Open Doc Editors Folder

ƒodf

to:

Open Doc Editors Folder

Âƒodf

Changed lines 69-72 from:

Gen Editors Folder	ƒedi
Help Folder	ƒhlp
Internet Plug In Folder	ƒnet
Modem Scripts Folder	ƒmod

to:

Gen Editors Folder	Âƒedi
Help Folder	Âƒhlp
Internet Plug In Folder	Âƒnet
Modem Scripts Folder	Âƒmod

Changed lines 74-76 from:

Printer Driver Folder	ƒprd
Scripting Additions Folder	ƒscr
Shared Libraries Folder	ƒlib

to:

Printer Driver Folder	Âƒprd
Scripting Additions Folder	Âƒscr
Shared Libraries Folder	Âƒlib

Changed lines 79-81 from:

Assistants Folder	astƒ
Utilities Folder	utiƒ
Apple Extras Folder	aexƒ

to:

Assistants Folder	astÂƒ
Utilities Folder	utiÂƒ
Apple Extras Folder	aexÂƒ

Changed line 83 from:

Mac OS ReadMe Files Folder

morƒ

to:

Mac OS ReadMe Files Folder

morÂƒ

Changed line 90 from:

Internet Folder

intƒ

to:

Internet Folder

intÂƒ

Changed line 93 from:

Desktop Pictures Folder

dtpƒ

to:

Desktop Pictures Folder

dtpÂƒ

Changed line 98 from:

Scripts Folder

scrƒ

to:

Scripts Folder

scrÂƒ

Changed line 112 from:

Note: some of the codes in the table above use the ƒ symbol. This is

to:

Note: some of the codes in the table above use the Âƒ symbol. This is

Changed line 121 from:

     «MacOS» version

to:

     Â«MacOSÂ» version

Changed line 124 from:

     «MacOS» info command getStandardFolder

to:

     Â«MacOSÂ» info command getStandardFolder

Changed line 127 from:

     «MacOS» getStandardFolder asup user

to:

     Â«MacOSÂ» getStandardFolder asup user

Changed line 130 from:

     «MacOS» getStandardFolder asup local

to:

     Â«MacOSÂ» getStandardFolder asup local

Changed line 133 from:

     «MacOS» getStandardFolder flnt user

to:

     Â«MacOSÂ» getStandardFolder flnt user

Changed line 136 from:

     «MacOS» getStandardFolder -create flnt user

to:

     Â«MacOSÂ» getStandardFolder -create flnt user

January 11, 2007, at 08:05 PM by bd - Title prettified

Added lines 1-2:

(:title The [getStandardFolder] command:)

June 15, 2006, at 07:56 PM by cbu - corrected minor typos

Changed line 6 from:

system-related directories. Optionnally this function can create (or

to:

system-related directories. Optionally this function can create (or

Added line 11:

Changed line 111 from:

It corresponds ot the U+0192 code-point in the Utf-8 Unicode encoding form.

to:

It corresponds to the U+0192 code-point in the Utf-8 Unicode encoding form.

Added line 115:

Changed line 117 from:

     Welcome to AlphaX's AlphaTcl shell.

to:

    Welcome to AlphaX's AlphaTcl shell.

April 26, 2006, at 08:05 PM by bd - Local link

Deleted line 0:

Changed line 16 from:

folderType is a four-character code characterizing a particular folder (see below).

to:

folderType is a four-character code characterizing a particular folder (see below).

Added line 19:

April 23, 2006, at 08:08 AM by 84.37.69.107 -

Added line 1:

Changed line 5 from:

The new command [getStandardFolder] has been introduced in order to wrap the

to:

The new command [getStandardFolder] has been introduced in order to wrap the

Changed lines 15-18 from:

The arguments are:

-create is optional: it tells to create the folder if it does not exist.
folderType is a four characters code designated the folder (see below).
domain is optional. It specifies the domain the folder belongs to. For instance there are several Fonts directories on the system, corresponding to different domains: /System/Library/Fonts in the System domain, /Library/Fonts in the local domain, or ~/Fonts in the user domain. Possible values for this parameter are: classic, local, network, system, or user. If it is not specified, the default value is system.

to:

The arguments have the following signification:

-create tells to attempt to create the folder if it does not exist. This argument is optional.
folderType is a four-character code characterizing a particular folder (see below).
domain is optional. It specifies the domain the folder belongs to. For instance, there are several Fonts directories on the system, corresponding to different domains: /System/Library/Fonts in the System domain, /Library/Fonts in the local domain, or ~/Fonts in the user domain. Possible values for this parameter are: classic, local, network, system, or user. If it is not specified, the default value is system.

Added line 24:

Added line 28:

Added lines 107-111:

Note: some of the codes in the table above use the ƒ symbol. This is the character of code 196 (0xc4 in hexadecimal) in the MacRoman encoding. It corresponds ot the U+0192 code-point in the Utf-8 Unicode encoding form. It is obtained from the keyboard by typing opt-f.

Changed line 113 from:

Here are some examples to demonstrate the use of the [getStandardFolder] command:

to:

Here are some examples to demonstrate the use of the [getStandardFolder] command:

Changed line 138 from:

Last updated 2006-04-23 09:53:46

to:

Last updated 2006-04-23 10:07:01

April 23, 2006, at 07:55 AM by 84.37.69.107 -

Added lines 1-130:

This page documents the new [getStandardFolder] command introduced in version 8.1d1 of AlphaX.

Description

The new command [getStandardFolder] has been introduced in order to wrap the ToolBox function of the same name. It returns the full path of certain system-related directories. Optionnally this function can create (or attempt to create, depending on the permissions) the folders when they do not exist already.

Synopsis

The syntax of the command is the following:

 
     getStandardFolder ?-create? folderType ?domain?

The arguments are:

-create is optional: it tells to create the folder if it does not exist.
folderType is a four characters code designated the folder (see below).
domain is optional. It specifies the domain the folder belongs to. For instance there are several Fonts directories on the system, corresponding to different domains: /System/Library/Fonts in the System domain, /Library/Fonts in the local domain, or ~/Fonts in the user domain. Possible values for this parameter are: classic, local, network, system, or user. If it is not specified, the default value is system.

Main folder codes

One must pass a four-character folder type for the folder you want to find. The table below indicates the currently available codes. More information can be found on Apple's Developer Connection at http://developer.apple.com/documentation/Carbon/Reference/Folder_Manager/Reference/reference.html#//apple_ref/c/tdef/FolderType These codes are declared in the Folders.h header found in the CoreServices framework (see /System/Library/Frameworks/CoreServices.framework/Versions/A/Frameworks/CarbonCore.framework/Versions/A/Headers/Folders.h).

Folder	Code
System Folder	macs
Desktop Folder	desk
System Desktop Folder	sdsk
Trash Folder	trsh
System Trash Folder	strs
Where To Empty Trash Folder	empt
Print Monitor Docs Folder	prnt
Startup Folder	strt
Shutdown Folder	shdf
Apple Menu Folder	amnu
Control Panel Folder	ctrl
System Control Panel Folder	sctl
Extension Folder	extn
Fonts Folder	font
Preferences Folder	pref
System Preferences Folder	sprf
Temporary Folder	temp
Extension Disabled Folder	extD
Control Panel Disabled Folder	ctrD
System Extension Disabled Folder	macD
Startup Items Disabled Folder	strD
Shutdown Items Disabled Folder	shdD
Applications Folder	apps
Documents Folder	docs
Volume Root Folder	root
Chewable Items Folder	flnt
Application Support Folder	asup
Text Encodings Folder	ƒtex
Stationery Folder	odst
Open Doc Folder	odod
Open Doc Shell PlugIns Folder	odsp
Editors Folder	oded
Open Doc Editors Folder	ƒodf
Open Doc Libraries Folder	odlb
Gen Editors Folder	ƒedi
Help Folder	ƒhlp
Internet Plug In Folder	ƒnet
Modem Scripts Folder	ƒmod
Printer Description Folder	ppdf
Printer Driver Folder	ƒprd
Scripting Additions Folder	ƒscr
Shared Libraries Folder	ƒlib
Voices Folder	fvoc
Control Strip Modules Folder	sdev
Assistants Folder	astƒ
Utilities Folder	utiƒ
Apple Extras Folder	aexƒ
Contextual Menu Items Folder	cmnu
Mac OS ReadMe Files Folder	morƒ
ALM Modules Folder	walk
ALM Preferences Folder	trip
ALM Locations Folder	fall
Color Sync Profiles Folder	prof
Themes Folder	thme
Favorites Folder	favs
Internet Folder	intƒ
Appearance Folder	appr
Sound Sets Folder	snds
Desktop Pictures Folder	dtpƒ
Internet Search Sites Folder	issf
Find Support Folder	fnds
Find By Content Folder	fbcf
Installer Logs Folder	ilgf
Scripts Folder	scrƒ
Folder Actions Folder	fasf
Launcher Items Folder	laun
Recent Applications Folder	rapp
Recent Documents Folder	rdoc
Recent Servers Folder	rsvr
Speakable Items Folder	spki
Keychain Folder	kchn
Quick Time Extensions Folder	qtex
Display Extensions Folder	dspl
Multiprocessing Folder	mpxf
Printing PlugIns Folder	pplg

Examples

Here are some examples to demonstrate the use of the [getStandardFolder] command:

 
     Welcome to AlphaX's AlphaTcl shell.
     «MacOS» version
     AlphaX 8.1d1, Wednesday, 11 January 2006

     «MacOS» info command getStandardFolder
     getStandardFolder

     «MacOS» getStandardFolder asup user
     /Users/bernardo/Library/Application Support/

     «MacOS» getStandardFolder asup local
     /Library/Application Support/

     «MacOS» getStandardFolder flnt user
     Error: 

     «MacOS» getStandardFolder -create flnt user
     /Users/bernardo/Library/Caches/Cleanup At Startup/

(add your comments here...)

Last updated 2006-04-23 09:53:46

The [getStandardFolder] command

Commands.GetStandardFolder History

Description

Synopsis

Main folder codes

Examples