[NTG-context] Problem or bug with enumerations in latest ConTeXt beta

2009-10-23 Thread Kevin D. Robbins
Hello all,

I have attached a fairly minimal example that demonstrates three problems I
currently have using an enumeration for code listings.

The first problem is that \placelist[enumeration:listing] errors out with:

! Missing number, treated as zero.

   )
\placestructurelist ...sts.process("#1","#2","#3")
  }
\doplacerawlist ...mber \listparameter \c!number }
  \stoplistreferences
\endgr...
\doplacelist ...ginoflist \doplacerawlist [#1][#2]
  \doendoflist

   \par
l.24

The second problem is that \in{Listing}[lst:b] produces Listing 2.2 rather
than Listing 2 as I expect since I've asked for numbering way=bytext in
\defineenumeration. How can I get the number produced by \in{Listing}[lst:b]
to match the listing number typeset in the listing title?

The third problem is that the document hyperlinks produced by
\in{Listing}[lst:b] with interaction enabled don't seem to do anything.

Cheers,

Kevin


test-enumerations.tex
Description: TeX document
___
If your question is of interest to others as well, please add an entry to the 
Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki : http://contextgarden.net
___


Re: [NTG-context] Page Numbering Hell

2009-10-23 Thread Taco Hoekwater
Hi,


Bryant Eastham wrote:
> 
> 1. Should I use mkii or mkiv? If mkii, then what should I plan on as
> schedule for upgrading?
> 2. Should I use context or texexec? As I understand, this is the same as
> asking whether to use pdftex or luatex. It may also be related to the
> mkii/mkiv issue, but I am less sure of that.

The (new) version of context that runs on luatex is called mkiv, the
(traditional) version that runs on pdftex as well as xetex is called
mkii.

There are two shell commands: texexec and context. Both of these
can run either mkii (pdftex or xetex) or mkiv (luatex), but they
have different defaults: 'texexec' defaults to mkii and 'context'
defaults to mkiv.

There are not a lot of core differences between mkii and mkiv, but
there are a few. The big thing on the user side is that mkiv is
totally based on Unicode and UTF-8, and knows how to do OpenType font
processing.

It follows that the commands that deal with input regimes and font
encodings are either stubs or missing, there is a slightly longer
list of differences here:

  http://wiki.contextgarden.net/MkIV_Differences

I hope that answers your question.

> 3. What *reference* material exists? I do not need a user guide. Right
> now it has been Google. However, the solutions most recently mentioned
> on the mailing lists seem to dead-end. I am fine with an answer of "see
> the source code" if that is really it.

The closest thing to a short reference is the command index
(texshow-web) at contextgarden:

  http://texshow.contextgarden.net/

However, this is a community effort with a slight lack of actual
community.

The cont-en[pi].pdf is Hans' context manual, which was originally
written in the nineties and is now slightly out of date.

The foundry.supelec.fr project (contextref/context-reference) is a
community attempt to update that manual.

Best wishes,
Taco
___
If your question is of interest to others as well, please add an entry to the 
Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki : http://contextgarden.net
___


Re: [NTG-context] Page Numbering Hell

2009-10-23 Thread Thomas A. Schmitz
Since you weren't satisfied with the reply you got, here's another  
attempt to please you:

On Oct 21, 2009, at 8:36 AM, Bryant Eastham wrote:


All-

A few days ago when I first stumbled on ConTeXt I was very, very  
excited. I have some 500 pages of technical documentation that could  
benefit from this, particularly since I need Japanese font support.  
But it has to be real.


I’m sorry if this sounds caustic, but after 12 hours of failed  
attempts to even get a minimal document formatted I have some  
serious questions for the list:


What do you mean "get even a minimal document formatted"? You're  
complaining that you don't find "current examples that actually work,"  
yet instead of a real minimal example, you post only rants. Give us a  
real example of what you have tried, and someone may be able to help  
you.


1.   Is Mark IV real? I am only somewhat joking here – after  
spending hours searching for reasonable documentation on even the  
most trivial options, I am left wondering whether this is something  
I want to use…


No Mkiv isn't real. For two years, we've all been part of this  
elaborate hoax. We pretend we're using a software that doesn't exist.


2.   ConTeXt looks great. But what is current? Seriously, I like  
the look and the support (particularly Unicode). But going over  
documentation I cannot make heads or tails of what to do. Mark II?  
Mark IV? TeTeX? LuaTeX? If I really want to use this, what should I  
use?


TeTeX is the odd item in your list. It's a defunct TeX system that  
hasn't been updated in three years or so. You may have meant XeTeX. On  
a serious note: For 95 % of ConTeXt, it doesn't matter what engine you  
use. The high-level code in your document should give identical output  
with pdftext (= mkii), XeTeX, or the new luatex engine (= mkiv). If  
you need Japanese, you will probably want to use XeTeX or luatex. For  
the differences between mkiv and mkii, see http://wiki.contextgarden.net/MkIV_Differences


3.   Having answered #2, where in the world is a reference  
manual!!! I mean one that actually *documents the options*.


What documentation did you read? cont-eni.pdf? The wiki? Have you  
looked at all the manuals available on http://www.pragma-ade.com/show-man-1.htm 
 ? cont-eni.pdf is still the current documentation; if you want to  
have a brief look at options, I would recommend http://texshow.contextgarden.net/


4.   Having answered #3, are there any current examples that  
actually work? The snippets from the mailing are great, but they are  
just snippets. That doesn’t help me.


What is missing on http://wiki.contextgarden.net/Sample_documents ?  
There are several sample documents.




Now, to resolve my immediate issue, and just because I will not be  
able to sleep well until I figure this out (yes, I am fixated on  
this).


I want this document structure:

Contents
1.   Chapter   1-1
1.1 Section 1-2
2.   Chapter 2  2-1
2.1 Section 2-2

Table of contents on page “i”.
Even/odd, each chapter starts on right page.
Page number (as in 2-2) in top margin.
Mark IV, Lua document.

I have tried hundreds of different combinations. If it cannot do  
this, the I will (with sadness) move on. I’m sure that it would take  
someone who understands this about 5 minutes to write (if that).


Then show us a minimal example of one of these hundreds of  
combinations, and somebody will look at it and may have an idea. But I  
doubt that anybody will want to write this for you.


Thomas
___
If your question is of interest to others as well, please add an entry to the 
Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki : http://contextgarden.net
___


Re: [NTG-context] Page Numbering Hell

2009-10-23 Thread Alan BRASLAU
On Wednesday 21 October 2009 16:24:47 Bryant Eastham wrote:
> 
> However, I find it interesting that in your response there was not a
> single real answer to any of my direct questions, nor a working example
> of what you admit should be a "simple matter".

I clearly wrote that I find the new structure code to be a bit
confusing, and invited "experts" to answer your specific questions
(also commented in my framework "example"):
> % missing setups to:
> % 1. frontmatter pagenumbering conversion=romannumerals
> % 2. bodymatter pagenumbering "chapter-page"
> % 3. reset pagenumber for each chapter
> % 4. add blank pages if necessary to start chapters on odd pages.
It should be simple, but I have not taken the time/not had the need
to look into this. Perhaps someone can easily fill this in
(that is if not put-off by the agressivity of the posting).

> However, I
> believe that my original statements, which boil down to "This thing may
> be great, but it needs to be documented (or where is it documented?)",
> have been strengthened.

Look at http://wiki.contextgarden.net/Main_Page
the paragraph on Documentation, and,
in particular, the revision of the user manual.
I, too, feel the great need for the updated
manual. For this reason, I am trying to join
the effort to bring forward its revision
(to be done in my "spare time").
Writing good, complete documentation is hard!

Alan
___
If your question is of interest to others as well, please add an entry to the 
Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki : http://contextgarden.net
___


Re: [NTG-context] Page Numbering Hell

2009-10-23 Thread luigi scarso
On Fri, Oct 23, 2009 at 9:19 AM, Taco Hoekwater  wrote:
> The foundry.supelec.fr project (contextref/context-reference) is a
> community attempt to update that manual.

Also
http://foundry.supelec.fr/gf/project/modules/

but more as testbed for mkiv, and they are rebuilded by me (on my
laptop at home) asap
everytime  Hans says "new beta" on this mailing list .

On long term, I hope I will able to make modules for mkii.

-- 
luigi
___
If your question is of interest to others as well, please add an entry to the 
Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki : http://contextgarden.net
___


Re: [NTG-context] Problem with TrueType MS Mincho, MKIV

2009-10-23 Thread Bryant Eastham
Thank you for your quick response! What is the process for getting the  
fix onto my machine? Just re-run the installer?


Thanks again!


Panasonic Electric Works Laboratory of America - SLC Lab
4525 So. Wasatch Blvd., Suite 100, 84124
Salt Lake City, UT 84124

T 801.993.7124
F 801.993.7269
beast...@pewla.us.pewg.pansonic.com
Bryant Eastham
Chief Architect

***CONFIDENTIALITY NOTICE***: This e-mail and any attachments may  
contain information which is confidential, proprietary, trade secret,  
privileged or otherwise protected by law. The information is the  
property of Panasonic Electric Works Laboratory of America, Inc., and  
is solely intended for the named addressee (or a person responsible or  
delivering it to the addressee). If you are not the intended recipient  
of this message, you are not authorized to read, print, retain copy or  
disseminate this message or any part of it. If you have received this  
e-mail in error, please notify the sender and the Office of General  
Counsel at generalcoun...@us.pewg.panasonic.com immediately by return  
e-mail and delete it from your computer.


On Oct 23, 2009, at 12:58 AM, "Taco Hoekwater"   
wrote:




Hi,

Bryant Eastham wrote:


Bug, or my lack of understanding?


Bug. There is a luatex fix in the repository already
(there is a small optimization in the font that I
handled badly).

Best wishes,
Taco

___



If your question is of interest to others as well, please add an  
entry to the Wiki!


maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki : http://contextgarden.net
___



___
If your question is of interest to others as well, please add an entry to the 
Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki : http://contextgarden.net
___


Re: [NTG-context] Page Numbering Hell

2009-10-23 Thread Aditya Mahajan

On Wed, 21 Oct 2009, Bryant Eastham wrote:


And I would still love a short, working example based on previous
request.


It seems that my previous reply was eaten by the server downtime. Here it 
is again, completing the missing step suggested by Alan.


% missing setups to:
% 1. frontmatter pagenumbering conversion=romannumerals
\setupuserpagenumber[way=byblock]
\definestructureconversionset[frontpart:pagenumber][][romannumerals]
\definestructureconversionset[bodypart:pagenumber] [][numbers]
\setupuserpagenumber[numberconversionset=pagenumber]

% 2. bodymatter pagenumbering "chapter-page"
% 3. reset pagenumber for each chapter
\setupuserpagenumber
  [way=bychapter,
   prefix=yes,
   prefixset=chapter,
   prefixsegments=2:2, % so that numbers come correctly in TOC
   prefixconnector=-,
 ]

% 4. add blank pages if necessary to start chapters on odd pages.
% 5. Page number in top margin
\setuppagenumbering[location={header,margin},alternative=doublesided]

\starttext

\startfrontmatter
\completecontent[criterium=all]
\stopfrontmatter

\startbodymatter
\dorecurse{4}
{\chapter{Chapter}
\dorecurse{8}
{\section{Section}
 \input knuth \endgraf}}
\stopbodymatter

\stoptext

Aditya
___
If your question is of interest to others as well, please add an entry to the 
Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki : http://contextgarden.net
___


Re: [NTG-context] Page Numbering Hell

2009-10-23 Thread Aditya Mahajan

On Wed, 21 Oct 2009, Bryant Eastham wrote:


1.   Is Mark IV real? I am only somewhat joking here - after
spending hours searching for reasonable documentation on even the most
trivial options, I am left wondering whether this is something I want to
use...


MKIV is still a moving target. For example, the change is the 
structure code (headings, pagenumbers, lists, etc) started only in April. 
There are still some things that are not done yet. Documentation will only 
make sense once the interface is stable. For structure code, the interface 
is not fixed yet, so the only documentation is the examples in the source 
file. Parts that are stable (fonts, typescripts) are documented in the new 
manual (see wiki). The interface for most other things has not changed, so 
the MKII interface works.



2.   ConTeXt looks great. But what is current? Seriously, I like the
look and the support (particularly Unicode). But going over
documentation I cannot make heads or tails of what to do. Mark II? Mark
IV? TeTeX? LuaTeX? If I really want to use this, what should I use?


Use MKII. It is stable and well documented. Unless there is some feature 
of MKIV that you definitely need. MKII had some support for unicode and 
oriental languages.



3.   Having answered #2, where in the world is a reference manual!!!
I mean one that actually *documents the options*.


See http://www.pragma-ade.com/overview.htm 
Most of MKII options are documented in ConTeXt the manual. Parts of MKIV are documented in mk.pdf



4.   Having answered #3, are there any current examples that
actually work? The snippets from the mailing are great, but they are
just snippets. That doesn't help me.


The wiki: http://www.contextgarden.net


Now, to resolve my immediate issue, and just because I will not be able
to sleep well until I figure this out (yes, I am fixated on this).


A partial solution (I don't know how to set the separator between chapter 
number and page number)


Following Alan's email:

% missing setups to:
% 1. frontmatter pagenumbering conversion=romannumerals
\setupuserpagenumber[way=byblock]
\definestructureconversionset[frontpart:pagenumber][][romannumerals]
\definestructureconversionset[bodypart:pagenumber] [][numbers]
\setupuserpagenumber[numberconversionset=pagenumber]

% 2. bodymatter pagenumbering "chapter-page"
% 3. reset pagenumber for each chapter
% I don't know how to set the - between chapter and page number

\setupuserpagenumber
  [way=bychapter,
   prefix=yes,
   prefixset=chapter,
   prefixsegments=2:2,
 ]

% 4. add blank pages if necessary to start chapters on odd pages.
% 5. Page number in top margin
\setuppagenumbering[location={header,margin},alternative=doublesided]

\starttext

\startfrontmatter
\completecontent[criterium=all]
\stopfrontmatter

\startbodymatter
\dorecurse{4}
{\chapter{Chapter}
\dorecurse{8}
{\section{Section}
 \input knuth \endgraf}}
\stopbodymatter

\stoptext

Aditya
___
If your question is of interest to others as well, please add an entry to the 
Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki : http://contextgarden.net
___


Re: [NTG-context] Problem with TrueType MS Mincho, MKIV

2009-10-23 Thread Taco Hoekwater


Bryant Eastham wrote:
> Thank you for your quick response! What is the process for getting the
> fix onto my machine? Just re-run the installer?

Not sure how the minimals are syncing the repository at the
moment, you may have to wait for my next beta luatex release
(early next week).

Of course you can compile from source as well, but that takes
a bit of study when you are not used to compiling executables
yourself.

Best wishes,
Taco


> Thanks again!
> 
> 
> Panasonic Electric Works Laboratory of America - SLC Lab
> 4525 So. Wasatch Blvd., Suite 100, 84124
> Salt Lake City, UT 84124
> 
> T 801.993.7124
> F 801.993.7269
> beast...@pewla.us.pewg.pansonic.com
> Bryant Eastham
> Chief Architect
> 
> ***CONFIDENTIALITY NOTICE***: This e-mail and any attachments may
> contain information which is confidential, proprietary, trade secret,
> privileged or otherwise protected by law. The information is the
> property of Panasonic Electric Works Laboratory of America, Inc., and is
> solely intended for the named addressee (or a person responsible or
> delivering it to the addressee). If you are not the intended recipient
> of this message, you are not authorized to read, print, retain copy or
> disseminate this message or any part of it. If you have received this
> e-mail in error, please notify the sender and the Office of General
> Counsel at generalcoun...@us.pewg.panasonic.com immediately by return
> e-mail and delete it from your computer.
> 
> On Oct 23, 2009, at 12:58 AM, "Taco Hoekwater"  wrote:
> 
>>
>> Hi,
>>
>> Bryant Eastham wrote:
>>>
>>> Bug, or my lack of understanding?
>>
>> Bug. There is a luatex fix in the repository already
>> (there is a small optimization in the font that I
>> handled badly).
>>
>> Best wishes,
>> Taco
>>
>> ___
>>
> 
> 
>> If your question is of interest to others as well, please add an entry
>> to the Wiki!
>>
>> maillist : ntg-context@ntg.nl /
>> http://www.ntg.nl/mailman/listinfo/ntg-context
>> webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
>> archive  : http://foundry.supelec.fr/projects/contextrev/
>> wiki : http://contextgarden.net
>> ___
>>
> 
> 
> ___
> 
> If your question is of interest to others as well, please add an entry
> to the Wiki!
> 
> maillist : ntg-context@ntg.nl /
> http://www.ntg.nl/mailman/listinfo/ntg-context
> webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
> archive  : http://foundry.supelec.fr/projects/contextrev/
> wiki : http://contextgarden.net
> ___
> 
___
If your question is of interest to others as well, please add an entry to the 
Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki : http://contextgarden.net
___


Re: [NTG-context] Page Numbering Hell

2009-10-23 Thread luigi scarso
http://randomdeterminism.wordpress.com/2009/10/21/creating-a-style-file-in-context/

On Wed, Oct 21, 2009 at 6:52 PM, Bryant Eastham
 wrote:
> All:
>
> Alan comments below on my "aggressive" post. I apologize if it was seen
> that way. I am serious in my evaluation of ConTeXt, and my questions are
> quite serious as well.
Yes ,we understand it.
> I cannot justify the effort in and cost of converting some 35 documents
> (many hundreds of pages) into a new format without an evaluation of the
> format and related tools.
35 documents of 1000 pages each one
(I mean 35000 pages)
is not a impressive volume.
The problems is converting from what-to-what, why, and how
For serious work you  should have  a full Adobe suite,
at least to minimize "political" problems  with your boss and customers.
And I raccomand mkii because it's stable -- but keep an eye on mkiv
because is the "future today". So can also happen that mkiv is waht
you need *now* .

> I am fine with an answer of "see
> the source code" if that is really it.
TeX is a programming language, and ConTeXt too.
Programming is a difficult task, and typographic programming is a
difficult task
of programming.
If you are fine with reading the source, it's really ok that you start
to read the source now
because there are many and many examples.
(if so, of course you should be able to make a short and working
example by yourself too,
because wiki is full of smal working examples).




-- 
luigi
___
If your question is of interest to others as well, please add an entry to the 
Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki : http://contextgarden.net
___


Re: [NTG-context] Page Numbering Hell

2009-10-23 Thread Bryant Eastham
Thomas, all:
 
It appears that not all of the messages have been delivered in a timely manner 
- I just received quite a few. I suppose that is why you reference the reply I 
got (or didn't until just now). FYI, it appears to me that there are major 
issues with the ntg.nl domain name server - it sometimes seems to go 
non-responsive. I can fix my local machine for web access, but I cannot change 
my mailer.
 
As I have already written, sorry for the caustic approach. I obviously have 
offended you, and apologize.
 
Most of your points are well taken. Yes, I had looked at all the examples that 
I could find, I had checked the many references, and could not find 
documentation on most of the routines that current postings seem to indicate 
should be used. With the further pointers I have received I will try again, and 
post my results.
 
As for my "real" comment, snide question begs snide response. I accept that. 
However, keep in mind that "real" to me doesn't mean "cool", or "full of 
features", or "better", but rather means that it will work, day in and day out, 
in a commercial environment. It means that it is tough, not brittle. It means 
that I can train people to use it, and then have them use it reliably. My 
comment is borne from the little that I can read about current status, my lack 
of ability to find a roadmap or schedule, and the fact that over the course of 
three solid days of probing, I have found several issues. It is not meant to 
diminish the groups efforts, their goals, or the current status - for all I 
know (and have been able to find) the group is small, has too much to do, and 
acknowledges that there is a long way to go! I don't know (didn't know when I 
asked), and couldn't find any statements one way or the other in my searching. 
In particular, it has nothing to do with the amount of effort or time devoted 
to the project. I will be the first to acknowledge that I am a leech, 
benefiting (at this point) from the groups efforts while not having provided 
anything in return.
 
Judging by other responses, the jury is out on "real" (at least of mkiv). I 
will continue to evaluate. And, my 35 documents, hundreds of pages was not 
meant to be multiplied! I have under 1,000 pages total.
 
Sorry for my typo (TeTeX).
 
Thanks to others for their responses. I will try them out tomorrow, and will be 
sure to collect all my hundreds of attempts for the amusement of the group - 
maybe in hopes of atoning for my "rant". :-)
 
-Bryant
 



From: ntg-context-boun...@ntg.nl on behalf of Thomas A. Schmitz
Sent: Wed 10/21/2009 2:57 PM
To: mailing list for ConTeXt users
Subject: Re: [NTG-context] Page Numbering Hell



Since you weren't satisfied with the reply you got, here's another 
attempt to please you:
On Oct 21, 2009, at 8:36 AM, Bryant Eastham wrote:

> All-
>
> A few days ago when I first stumbled on ConTeXt I was very, very 
> excited. I have some 500 pages of technical documentation that could 
> benefit from this, particularly since I need Japanese font support. 
> But it has to be real.
>
> I'm sorry if this sounds caustic, but after 12 hours of failed 
> attempts to even get a minimal document formatted I have some 
> serious questions for the list:

What do you mean "get even a minimal document formatted"? You're 
complaining that you don't find "current examples that actually work," 
yet instead of a real minimal example, you post only rants. Give us a 
real example of what you have tried, and someone may be able to help 
you.
>
> 1.   Is Mark IV real? I am only somewhat joking here - after 
> spending hours searching for reasonable documentation on even the 
> most trivial options, I am left wondering whether this is something 
> I want to use...

No Mkiv isn't real. For two years, we've all been part of this 
elaborate hoax. We pretend we're using a software that doesn't exist.

> 2.   ConTeXt looks great. But what is current? Seriously, I like 
> the look and the support (particularly Unicode). But going over 
> documentation I cannot make heads or tails of what to do. Mark II? 
> Mark IV? TeTeX? LuaTeX? If I really want to use this, what should I 
> use?

TeTeX is the odd item in your list. It's a defunct TeX system that 
hasn't been updated in three years or so. You may have meant XeTeX. On 
a serious note: For 95 % of ConTeXt, it doesn't matter what engine you 
use. The high-level code in your document should give identical output 
with pdftext (= mkii), XeTeX, or the new luatex engine (= mkiv). If 
you need Japanese, you will probably want to use XeTeX or luatex. For 
the differences between mkiv and mkii, see 
http://wiki.contextgarden.net/MkIV_Differences

> 3.   Having answered #2, where in the world is a reference 
> manual!!! I mean one that actually *documents the options*.

What documentation did you read? cont-eni.pdf? The wiki? Have you 
looked at all the manuals available on http://www.pragma-ade.com/show-man-1.htm
  ? co