Re: [Zope3-Users] documentation on Field types

2005-11-12 Thread Stephan Richter
On Friday 04 November 2005 00:07, Ross Boylan wrote:
> Where should I look for documentation on Field types?  By this, I mean
> a current, exhaustive list of allowed Field types and their arguments.

There is none.

> I suspect when I go to the API documentation and enter zope.schema I'm
> getting the values, with some translation.  But since those entries
> are in terms of interfaces and not the actual names to use (e.g.,
> IText, not Text), I'd like to know more about how they relate.

Well, all data fields defined in those interfaces are keyword arguments in the 
constructor.

> The "Programming with Zope 3" Tutorial and Richter's Developer's
> Handbook both discuss and list various options, but they have several
> limitations:
> * they aren't current
> * they aren't exhaustive
> * they aren't in the online help system.
>
> I'm looking for something that meets those requirements.

Look at zope.schema._field and zope.schema._bootstrapfields

Regards,
Stephan
-- 
Stephan Richter
CBU Physics & Chemistry (B.S.) / Tufts Physics (Ph.D. student)
Web2k - Web Software Design, Development and Training
___
Zope3-users mailing list
Zope3-users@zope.org
http://mail.zope.org/mailman/listinfo/zope3-users


[Zope3-Users] documentation on Field types

2005-11-03 Thread Ross Boylan
Where should I look for documentation on Field types?  By this, I mean
a current, exhaustive list of allowed Field types and their arguments.

I suspect when I go to the API documentation and enter zope.schema I'm
getting the values, with some translation.  But since those entries
are in terms of interfaces and not the actual names to use (e.g.,
IText, not Text), I'd like to know more about how they relate.

The "Programming with Zope 3" Tutorial and Richter's Developer's
Handbook both discuss and list various options, but they have several
limitations:
* they aren't current
* they aren't exhaustive
* they aren't in the online help system.

I'm looking for something that meets those requirements.

The online book, in the entry Interfaces and Schemas | Schema Fields,
begins "This document highlights unusual and subtle aspects of various
fields and field classes, and is not intended to be a general
introduction to schema fields. Please see README.txt for a more
general introduction."

I suggest changing this two ways.  First, the "Schema Fields" section
should appear after "Schemas."  Second, the reference should be
changed from "README.txt" (which is non-unique and wasn't even present
in my Debian distro) to "Schemas".  "Schemas" appears to be the same
as the README.txt that I eventually found in the source tree.

As far as I can tell, no section of the Book in the online help has
anything near a complete discussion of the allowed field types.
___
Zope3-users mailing list
Zope3-users@zope.org
http://mail.zope.org/mailman/listinfo/zope3-users