[Python-checkins] CVS: python/dist/src/Mac/Modules/scrap _Scrapmodule.c,1.1,1.1.14.1 scrapscan.py,1.4,1.4.20.1 scrapsupport.py,1.4,1.4.14.1
Jack Jansen
jackjansen@users.sourceforge.net
Wed, 27 Feb 2002 15:17:24 -0800
- Previous message: [Python-checkins] CVS: python/dist/src/Mac/Modules/res _Resmodule.c,1.7,1.7.4.1 resscan.py,1.14,1.14.4.1 ressupport.py,1.18,1.18.4.1
- Next message: [Python-checkins] CVS: python/dist/src/Mac/Modules/snd _Sndmodule.c,1.6,1.6.4.1 sndscan.py,1.15,1.15.20.1 sndsupport.py,1.18,1.18.14.1
- Messages sorted by:
[ date ]
[ thread ]
[ subject ]
[ author ]
Update of /cvsroot/python/python/dist/src/Mac/Modules/scrap
In directory usw-pr-cvs1:/tmp/cvs-serv3034/scrap
Modified Files:
Tag: release22-maint
_Scrapmodule.c scrapscan.py scrapsupport.py
Log Message:
Backport of 1.2:
Added support for the Carbon scrap manager (finally).
Index: _Scrapmodule.c
===================================================================
RCS file: /cvsroot/python/python/dist/src/Mac/Modules/scrap/_Scrapmodule.c,v
retrieving revision 1.1
retrieving revision 1.1.14.1
diff -C2 -d -r1.1 -r1.1.14.1
*** _Scrapmodule.c 23 Aug 2001 14:02:09 -0000 1.1
--- _Scrapmodule.c 27 Feb 2002 23:17:21 -0000 1.1.14.1
***************
*** 1,4 ****
! /* ========================== Module Scrap ========================== */
#include "Python.h"
--- 1,4 ----
! /* ========================= Module _Scrap ========================== */
#include "Python.h"
***************
*** 6,11 ****
--- 6,23 ----
+ #ifdef _WIN32
+ #include "pywintoolbox.h"
+ #else
#include "macglue.h"
#include "pymactoolbox.h"
+ #endif
+
+ /* Macro to test whether a weak-loaded CFM function exists */
+ #define PyMac_PRECHECK(rtn) do { if ( &rtn == NULL ) {\
+ PyErr_SetString(PyExc_NotImplementedError, \
+ "Not available in this shared library/OS version"); \
+ return NULL; \
+ }} while(0)
+
#ifdef WITHOUT_FRAMEWORKS
***************
*** 15,19 ****
#endif
! #if !TARGET_API_MAC_CARBON
/*
--- 27,31 ----
#endif
! #if TARGET_API_MAC_OS8
/*
***************
*** 33,39 ****
static PyObject *Scrap_Error;
! static PyObject *Scrap_LoadScrap(_self, _args)
! PyObject *_self;
! PyObject *_args;
{
PyObject *_res = NULL;
--- 45,284 ----
static PyObject *Scrap_Error;
! #if !TARGET_API_MAC_OS8
! /* ----------------------- Object type Scrap ------------------------ */
!
! PyTypeObject Scrap_Type;
!
! #define ScrapObj_Check(x) ((x)->ob_type == &Scrap_Type)
!
! typedef struct ScrapObject {
! PyObject_HEAD
! ScrapRef ob_itself;
! } ScrapObject;
!
! PyObject *ScrapObj_New(ScrapRef itself)
! {
! ScrapObject *it;
! it = PyObject_NEW(ScrapObject, &Scrap_Type);
! if (it == NULL) return NULL;
! it->ob_itself = itself;
! return (PyObject *)it;
! }
! int ScrapObj_Convert(PyObject *v, ScrapRef *p_itself)
! {
! if (!ScrapObj_Check(v))
! {
! PyErr_SetString(PyExc_TypeError, "Scrap required");
! return 0;
! }
! *p_itself = ((ScrapObject *)v)->ob_itself;
! return 1;
! }
!
! static void ScrapObj_dealloc(ScrapObject *self)
! {
! /* Cleanup of self->ob_itself goes here */
! PyMem_DEL(self);
! }
!
! static PyObject *ScrapObj_GetScrapFlavorFlags(ScrapObject *_self, PyObject *_args)
! {
! PyObject *_res = NULL;
! OSStatus _err;
! ScrapFlavorType flavorType;
! ScrapFlavorFlags flavorFlags;
! if (!PyArg_ParseTuple(_args, "O&",
! PyMac_GetOSType, &flavorType))
! return NULL;
! _err = GetScrapFlavorFlags(_self->ob_itself,
! flavorType,
! &flavorFlags);
! if (_err != noErr) return PyMac_Error(_err);
! _res = Py_BuildValue("l",
! flavorFlags);
! return _res;
! }
!
! static PyObject *ScrapObj_GetScrapFlavorSize(ScrapObject *_self, PyObject *_args)
! {
! PyObject *_res = NULL;
! OSStatus _err;
! ScrapFlavorType flavorType;
! Size byteCount;
! if (!PyArg_ParseTuple(_args, "O&",
! PyMac_GetOSType, &flavorType))
! return NULL;
! _err = GetScrapFlavorSize(_self->ob_itself,
! flavorType,
! &byteCount);
! if (_err != noErr) return PyMac_Error(_err);
! _res = Py_BuildValue("l",
! byteCount);
! return _res;
! }
!
! static PyObject *ScrapObj_GetScrapFlavorData(ScrapObject *_self, PyObject *_args)
! {
! PyObject *_res = NULL;
! OSStatus _err;
! ScrapFlavorType flavorType;
! Size byteCount;
!
! if (!PyArg_ParseTuple(_args, "O&",
! PyMac_GetOSType, &flavorType))
! return NULL;
! _err = GetScrapFlavorSize(_self->ob_itself,
! flavorType,
! &byteCount);
! if (_err != noErr) return PyMac_Error(_err);
! _res = PyString_FromStringAndSize(NULL, (int)byteCount);
! if ( _res == NULL ) return NULL;
! _err = GetScrapFlavorData(_self->ob_itself,
! flavorType,
! &byteCount,
! PyString_AS_STRING(_res));
! if (_err != noErr) {
! Py_XDECREF(_res);
! return PyMac_Error(_err);
! }
! destination__error__: ;
! return _res;
! }
!
! static PyObject *ScrapObj_PutScrapFlavor(ScrapObject *_self, PyObject *_args)
! {
! PyObject *_res = NULL;
! OSStatus _err;
! ScrapFlavorType flavorType;
! ScrapFlavorFlags flavorFlags;
! char *flavorData__in__;
! int flavorData__in_len__;
! if (!PyArg_ParseTuple(_args, "O&ls#",
! PyMac_GetOSType, &flavorType,
! &flavorFlags,
! &flavorData__in__, &flavorData__in_len__))
! return NULL;
! _err = PutScrapFlavor(_self->ob_itself,
! flavorType,
! flavorFlags,
! (Size)flavorData__in_len__,
! flavorData__in__);
! if (_err != noErr) return PyMac_Error(_err);
! Py_INCREF(Py_None);
! _res = Py_None;
! flavorData__error__: ;
! return _res;
! }
!
! static PyObject *ScrapObj_GetScrapFlavorCount(ScrapObject *_self, PyObject *_args)
! {
! PyObject *_res = NULL;
! OSStatus _err;
! UInt32 infoCount;
! if (!PyArg_ParseTuple(_args, ""))
! return NULL;
! _err = GetScrapFlavorCount(_self->ob_itself,
! &infoCount);
! if (_err != noErr) return PyMac_Error(_err);
! _res = Py_BuildValue("l",
! infoCount);
! return _res;
! }
!
! static PyObject *ScrapObj_GetScrapFlavorInfoList(ScrapObject *_self, PyObject *_args)
! {
! PyObject *_res = NULL;
! PyObject *item;
! OSStatus _err;
! UInt32 infoCount;
! ScrapFlavorInfo *infolist = NULL;
! int i;
!
! if (!PyArg_ParseTuple(_args, ""))
! return NULL;
! _err = GetScrapFlavorCount(_self->ob_itself,
! &infoCount);
! if (_err != noErr) return PyMac_Error(_err);
! if (infoCount == 0) return Py_BuildValue("[]");
!
! if ((infolist = (ScrapFlavorInfo *)malloc(infoCount*sizeof(ScrapFlavorInfo))) == NULL )
! return PyErr_NoMemory();
!
! _err = GetScrapFlavorInfoList(_self->ob_itself, &infoCount, infolist);
! if (_err != noErr) {
! free(infolist);
! return NULL;
! }
! if ((_res = PyList_New(infoCount)) == NULL ) {
! free(infolist);
! return NULL;
! }
! for(i=0; i<infoCount; i++) {
! item = Py_BuildValue("O&l", PyMac_BuildOSType, infolist[i].flavorType,
! infolist[i].flavorFlags);
! if ( !item || PyList_SetItem(_res, i, item) < 0 ) {
! Py_DECREF(_res);
! free(infolist);
! return NULL;
! }
! }
! free(infolist);
! return _res;
! }
!
! static PyMethodDef ScrapObj_methods[] = {
! {"GetScrapFlavorFlags", (PyCFunction)ScrapObj_GetScrapFlavorFlags, 1,
! "(ScrapFlavorType flavorType) -> (ScrapFlavorFlags flavorFlags)"},
! {"GetScrapFlavorSize", (PyCFunction)ScrapObj_GetScrapFlavorSize, 1,
! "(ScrapFlavorType flavorType) -> (Size byteCount)"},
! {"GetScrapFlavorData", (PyCFunction)ScrapObj_GetScrapFlavorData, 1,
! "(ScrapFlavorType flavorType) -> string"},
! {"PutScrapFlavor", (PyCFunction)ScrapObj_PutScrapFlavor, 1,
! "(ScrapFlavorType flavorType, ScrapFlavorFlags flavorFlags, Buffer flavorData) -> None"},
! {"GetScrapFlavorCount", (PyCFunction)ScrapObj_GetScrapFlavorCount, 1,
! "() -> (UInt32 infoCount)"},
! {"GetScrapFlavorInfoList", (PyCFunction)ScrapObj_GetScrapFlavorInfoList, 1,
! "() -> ([(ScrapFlavorType, ScrapFlavorInfo), ...])"},
! {NULL, NULL, 0}
! };
!
! PyMethodChain ScrapObj_chain = { ScrapObj_methods, NULL };
!
! static PyObject *ScrapObj_getattr(ScrapObject *self, char *name)
! {
! return Py_FindMethodInChain(&ScrapObj_chain, (PyObject *)self, name);
! }
!
! #define ScrapObj_setattr NULL
!
! #define ScrapObj_compare NULL
!
! #define ScrapObj_repr NULL
!
! #define ScrapObj_hash NULL
!
! PyTypeObject Scrap_Type = {
! PyObject_HEAD_INIT(NULL)
! 0, /*ob_size*/
! "_Scrap.Scrap", /*tp_name*/
! sizeof(ScrapObject), /*tp_basicsize*/
! 0, /*tp_itemsize*/
! /* methods */
! (destructor) ScrapObj_dealloc, /*tp_dealloc*/
! 0, /*tp_print*/
! (getattrfunc) ScrapObj_getattr, /*tp_getattr*/
! (setattrfunc) ScrapObj_setattr, /*tp_setattr*/
! (cmpfunc) ScrapObj_compare, /*tp_compare*/
! (reprfunc) ScrapObj_repr, /*tp_repr*/
! (PyNumberMethods *)0, /* tp_as_number */
! (PySequenceMethods *)0, /* tp_as_sequence */
! (PyMappingMethods *)0, /* tp_as_mapping */
! (hashfunc) ScrapObj_hash, /*tp_hash*/
! };
!
! /* --------------------- End object type Scrap ---------------------- */
! #endif /* !TARGET_API_MAC_OS8 */
!
! static PyObject *Scrap_LoadScrap(PyObject *_self, PyObject *_args)
{
PyObject *_res = NULL;
***************
*** 48,54 ****
}
! static PyObject *Scrap_UnloadScrap(_self, _args)
! PyObject *_self;
! PyObject *_args;
{
PyObject *_res = NULL;
--- 293,297 ----
}
! static PyObject *Scrap_UnloadScrap(PyObject *_self, PyObject *_args)
{
PyObject *_res = NULL;
***************
*** 63,71 ****
}
! #if !TARGET_API_MAC_CARBON
! static PyObject *Scrap_InfoScrap(_self, _args)
! PyObject *_self;
! PyObject *_args;
{
PyObject *_res = NULL;
--- 306,312 ----
}
! #if TARGET_API_MAC_OS8
! static PyObject *Scrap_InfoScrap(PyObject *_self, PyObject *_args)
{
PyObject *_res = NULL;
***************
*** 78,88 ****
return _res;
}
- #endif
! #if !TARGET_API_MAC_CARBON
!
! static PyObject *Scrap_GetScrap(_self, _args)
! PyObject *_self;
! PyObject *_args;
{
PyObject *_res = NULL;
--- 319,324 ----
return _res;
}
! static PyObject *Scrap_GetScrap(PyObject *_self, PyObject *_args)
{
PyObject *_res = NULL;
***************
*** 103,112 ****
return _res;
}
- #endif
-
! static PyObject *Scrap_ZeroScrap(_self, _args)
! PyObject *_self;
! PyObject *_args;
{
PyObject *_res = NULL;
--- 339,344 ----
return _res;
}
! static PyObject *Scrap_ZeroScrap(PyObject *_self, PyObject *_args)
{
PyObject *_res = NULL;
***************
*** 114,128 ****
if (!PyArg_ParseTuple(_args, ""))
return NULL;
- #if TARGET_API_MAC_CARBON
- {
- ScrapRef scrap;
-
- _err = ClearCurrentScrap();
- if (_err != noErr) return PyMac_Error(_err);
- _err = GetCurrentScrap(&scrap);
- }
- #else
_err = ZeroScrap();
- #endif
if (_err != noErr) return PyMac_Error(_err);
Py_INCREF(Py_None);
--- 346,350 ----
***************
*** 131,137 ****
}
! static PyObject *Scrap_PutScrap(_self, _args)
! PyObject *_self;
! PyObject *_args;
{
PyObject *_res = NULL;
--- 353,357 ----
}
! static PyObject *Scrap_PutScrap(PyObject *_self, PyObject *_args)
{
PyObject *_res = NULL;
***************
*** 142,164 ****
int sourceBuffer__len__;
int sourceBuffer__in_len__;
! #if TARGET_API_MAC_CARBON
! ScrapRef scrap;
! #endif
!
! if (!PyArg_ParseTuple(_args, "O&s#",
PyMac_GetOSType, &flavorType,
&sourceBuffer__in__, &sourceBuffer__in_len__))
return NULL;
- sourceBufferByteCount = sourceBuffer__in_len__;
- sourceBuffer__len__ = sourceBuffer__in_len__;
- #if TARGET_API_MAC_CARBON
- _err = GetCurrentScrap(&scrap);
- if (_err != noErr) return PyMac_Error(_err);
- _err = PutScrapFlavor(scrap, flavorType, 0, sourceBufferByteCount, sourceBuffer__in__);
- #else
_err = PutScrap(sourceBufferByteCount,
flavorType,
sourceBuffer__in__);
- #endif
if (_err != noErr) return PyMac_Error(_err);
Py_INCREF(Py_None);
--- 362,373 ----
int sourceBuffer__len__;
int sourceBuffer__in_len__;
! if (!PyArg_ParseTuple(_args, "lO&s#",
! &sourceBufferByteCount,
PyMac_GetOSType, &flavorType,
&sourceBuffer__in__, &sourceBuffer__in_len__))
return NULL;
_err = PutScrap(sourceBufferByteCount,
flavorType,
sourceBuffer__in__);
if (_err != noErr) return PyMac_Error(_err);
Py_INCREF(Py_None);
***************
*** 167,176 ****
return _res;
}
! #if TARGET_API_MAC_CARBON
! static PyObject *Scrap_ClearCurrentScrap(_self, _args)
! PyObject *_self;
! PyObject *_args;
{
PyObject *_res = NULL;
--- 376,397 ----
return _res;
}
+ #endif /* TARGET_API_MAC_OS8 */
! #if !TARGET_API_MAC_OS8
! static PyObject *Scrap_GetCurrentScrap(PyObject *_self, PyObject *_args)
! {
! PyObject *_res = NULL;
! OSStatus _err;
! ScrapRef scrap;
! if (!PyArg_ParseTuple(_args, ""))
! return NULL;
! _err = GetCurrentScrap(&scrap);
! if (_err != noErr) return PyMac_Error(_err);
! _res = Py_BuildValue("O&",
! ScrapObj_New, scrap);
! return _res;
! }
! static PyObject *Scrap_ClearCurrentScrap(PyObject *_self, PyObject *_args)
{
PyObject *_res = NULL;
***************
*** 184,194 ****
return _res;
}
- #endif
! #if TARGET_API_MAC_CARBON
!
! static PyObject *Scrap_CallInScrapPromises(_self, _args)
! PyObject *_self;
! PyObject *_args;
{
PyObject *_res = NULL;
--- 405,410 ----
return _res;
}
! static PyObject *Scrap_CallInScrapPromises(PyObject *_self, PyObject *_args)
{
PyObject *_res = NULL;
***************
*** 210,235 ****
"() -> None"},
! #if !TARGET_API_MAC_CARBON
{"InfoScrap", (PyCFunction)Scrap_InfoScrap, 1,
"() -> (ScrapStuffPtr _rv)"},
- #endif
-
- #if !TARGET_API_MAC_CARBON
{"GetScrap", (PyCFunction)Scrap_GetScrap, 1,
"(Handle destination, ScrapFlavorType flavorType) -> (long _rv, SInt32 offset)"},
- #endif
-
{"ZeroScrap", (PyCFunction)Scrap_ZeroScrap, 1,
"() -> None"},
-
{"PutScrap", (PyCFunction)Scrap_PutScrap, 1,
! "(ScrapFlavorType flavorType, Buffer sourceBuffer) -> None"},
! #if TARGET_API_MAC_CARBON
{"ClearCurrentScrap", (PyCFunction)Scrap_ClearCurrentScrap, 1,
"() -> None"},
- #endif
-
- #if TARGET_API_MAC_CARBON
{"CallInScrapPromises", (PyCFunction)Scrap_CallInScrapPromises, 1,
"() -> None"},
--- 426,445 ----
"() -> None"},
! #if TARGET_API_MAC_OS8
{"InfoScrap", (PyCFunction)Scrap_InfoScrap, 1,
"() -> (ScrapStuffPtr _rv)"},
{"GetScrap", (PyCFunction)Scrap_GetScrap, 1,
"(Handle destination, ScrapFlavorType flavorType) -> (long _rv, SInt32 offset)"},
{"ZeroScrap", (PyCFunction)Scrap_ZeroScrap, 1,
"() -> None"},
{"PutScrap", (PyCFunction)Scrap_PutScrap, 1,
! "(SInt32 sourceBufferByteCount, ScrapFlavorType flavorType, Buffer sourceBuffer) -> None"},
! #endif
! #if !TARGET_API_MAC_OS8
! {"GetCurrentScrap", (PyCFunction)Scrap_GetCurrentScrap, 1,
! "() -> (ScrapRef scrap)"},
{"ClearCurrentScrap", (PyCFunction)Scrap_ClearCurrentScrap, 1,
"() -> None"},
{"CallInScrapPromises", (PyCFunction)Scrap_CallInScrapPromises, 1,
"() -> None"},
***************
*** 241,245 ****
! void init_Scrap()
{
PyObject *m;
--- 451,455 ----
! void init_Scrap(void)
{
PyObject *m;
***************
*** 255,260 ****
PyDict_SetItemString(d, "Error", Scrap_Error) != 0)
return;
}
! /* ======================== End module Scrap ======================== */
--- 465,476 ----
PyDict_SetItemString(d, "Error", Scrap_Error) != 0)
return;
+ #if !TARGET_API_MAC_OS8
+ Scrap_Type.ob_type = &PyType_Type;
+ Py_INCREF(&Scrap_Type);
+ if (PyDict_SetItemString(d, "ScrapType", (PyObject *)&Scrap_Type) != 0)
+ Py_FatalError("can't initialize ScrapType");
+ #endif
}
! /* ======================= End module _Scrap ======================== */
Index: scrapscan.py
===================================================================
RCS file: /cvsroot/python/python/dist/src/Mac/Modules/scrap/scrapscan.py,v
retrieving revision 1.4
retrieving revision 1.4.20.1
diff -C2 -d -r1.4 -r1.4.20.1
*** scrapscan.py 24 Jan 2001 16:04:01 -0000 1.4
--- scrapscan.py 27 Feb 2002 23:17:21 -0000 1.4.20.1
***************
*** 6,10 ****
import sys
import os
! BGENDIR=os.path.join(sys.prefix, ':Tools:bgen:bgen')
sys.path.append(BGENDIR)
from scantools import Scanner
--- 6,13 ----
import sys
import os
! if os.sep == ':':
! BGENDIR=os.path.join(sys.prefix, ':Tools:bgen:bgen')
! else:
! BGENDIR="../../../Tools/bgen/bgen"
sys.path.append(BGENDIR)
from scantools import Scanner
***************
*** 30,37 ****
--- 33,46 ----
classname = "Function"
listname = "functions"
+ if arglist:
+ t, n, m = arglist[0]
+ if t == 'ScrapRef' and m == "InMode":
+ classname = "Method"
+ listname = "methods"
return classname, listname
def makeblacklistnames(self):
return [
+ "GetScrapFlavorInfoList",
]
***************
*** 51,55 ****
def makeblacklisttypes(self):
return [
! "ScrapRef", # For now -- This is the Carbon scrap main object
]
--- 60,64 ----
def makeblacklisttypes(self):
return [
! 'ScrapPromiseKeeperUPP',
]
Index: scrapsupport.py
===================================================================
RCS file: /cvsroot/python/python/dist/src/Mac/Modules/scrap/scrapsupport.py,v
retrieving revision 1.4
retrieving revision 1.4.14.1
diff -C2 -d -r1.4 -r1.4.14.1
*** scrapsupport.py 23 Aug 2001 13:50:47 -0000 1.4
--- scrapsupport.py 27 Feb 2002 23:17:21 -0000 1.4.14.1
***************
*** 12,18 ****
--- 12,21 ----
MACHEADERFILE = 'Scrap.h' # The Apple header file
MODNAME = '_Scrap' # The name of the module
+ OBJECTNAME = 'Scrap' # The basic name of the objects used here
# The following is *usually* unchanged but may still require tuning
MODPREFIX = 'Scrap' # The prefix for module-wide routines
+ OBJECTTYPE = OBJECTNAME + 'Ref' # The C type used to represent them
+ OBJECTPREFIX = MODPREFIX + 'Obj' # The prefix for object methods
INPUTFILE = string.lower(MODPREFIX) + 'gen.py' # The file generated by the scanner
OUTPUTFILE = '@' + MODNAME + "module.c" # The file generated by this program
***************
*** 21,24 ****
--- 24,28 ----
# Create the type objects
+ ScrapRef = OpaqueByValueType(OBJECTTYPE, OBJECTPREFIX)
includestuff = includestuff + """
***************
*** 45,58 ****
--- 49,71 ----
ScrapStuffPtr = OpaqueByValueType('ScrapStuffPtr', 'SCRRec')
ScrapFlavorType = OSTypeType('ScrapFlavorType')
+ ScrapFlavorFlags = Type('ScrapFlavorFlags', 'l')
+ #ScrapFlavorInfo = OpaqueType('ScrapFlavorInfo', 'ScrapFlavorInfo')
putscrapbuffer = FixedInputBufferType('void *')
+ class MyObjectDefinition(GlobalObjectDefinition):
+ pass
+
# Create the generator groups and link them
module = MacModule(MODNAME, MODPREFIX, includestuff, finalstuff, initstuff)
+ object = MyObjectDefinition(OBJECTNAME, OBJECTPREFIX, OBJECTTYPE)
+ module.addobject(object)
# Create the generator classes used to populate the lists
Function = OSErrFunctionGenerator
+ Method = OSErrMethodGenerator
# Create and populate the lists
functions = []
+ methods = []
execfile(INPUTFILE)
***************
*** 60,63 ****
--- 73,77 ----
# (in a different wordl the scan program would generate this)
for f in functions: module.add(f)
+ for f in methods: object.add(f)
# generate output (open the output file as late as possible)
- Previous message: [Python-checkins] CVS: python/dist/src/Mac/Modules/res _Resmodule.c,1.7,1.7.4.1 resscan.py,1.14,1.14.4.1 ressupport.py,1.18,1.18.4.1
- Next message: [Python-checkins] CVS: python/dist/src/Mac/Modules/snd _Sndmodule.c,1.6,1.6.4.1 sndscan.py,1.15,1.15.20.1 sndsupport.py,1.18,1.18.14.1
- Messages sorted by:
[ date ]
[ thread ]
[ subject ]
[ author ]